



まえがぎ 


r 音 里吉里 ^KAGj に 興味をもつ てい te だき、 35 りがとうご ざいます0 

r 吉里吉里」は、 [ tjs 」 というプログラミング言語を使ってマルチメディアタイトルを作 
るためのツールです。 「KAG」 はその「吉里吉里」をノベル•アドベンチャーゲームとして動 
作させるためのスクリプト群です。 

この本は「吉里吉里/ KAG」 でゲームを作ろうと考えている方を対象にしています。前半、 
「KAG」 について PIA 少尉さんに解説いただき、後半は私 （W.Dee) が 「TJS」 について解説 
しています。 

「KAG」 は、ノベル.アドベンチャーゲームを、簡単なテキスト.ファイルの記述で制作 
できるのです。一方、 「TJS」 は、 Java や JavaScript といった言語に似 ft プログラミング言語 
で、 「KAG」 よりもより「吉里吉里」本体やコンピュータ側に近い操作を行ないます。 

「KAGJ でできることは広く、その機能を知るにつれて、きっと想像力をかきたてられる 
と思います。そのうえ、何か特別なことをやりたいと思った場合は、 「TJS」 を使ってより詳 
細に「吉里吉里 J を操作することができます。また、 KAG 自体が 「TJSJ で記述されている 
ため、改造が比較的容易です。「吉里吉里/ KAGJ においては、この 「KAGJ と rTJSj を組 
み合わせて使えることが、大きな特徴です。 . 

できることが広いというと、何か難しそうで踏み入るには勇気が要るように思われるかも 
しれません。しかし、最初の一歩を踏み出せば、あとはどんどんと進んでいけるものだと思 
います。この本がその道しるべとなり、皆様のお役に立てることを願います。 

鼸醉 

「吉里吉里」は、もともとは自分 (WDee) 自身が使うために作られ、 r 目的」を達成す 
るための「手段」でした。それがいつのまにか「手段」から「目的」に変わり、ついにはこ 
のたびのように本を書かせていただけることにまでなったのは、自分自身でも驚くべきこと 
であると思っています。 KAG 編の執筆に快く応じてくださった PIA 少尉さん、書籍への収録 
を許可してくださった方々に感謝いたします。 

また、 r 吉里吉里/ KAG」 は私一人の力で作り上げられたものではありません。多くの方々 
のご意見をうけて作り上げられたものです。作品を世に公開された方々、作品を製作中の 
方々、デバッグに協力してくださった方々、ありがたい助言を下さった方々、奇行に付き合 
って下さった方々、「吉里吉里/ KAG 推進委員会 J の方々、 IRC チャンネル r#kirikiriircj の 
方々、そしてこの本を読んでくださる方々に、深く感謝の意を表わしたいと思います。 

2003 年 S 月吉日 W.Dee 







全_のク11ェイターの皆さん、最近ゲームを作〇ていますか？ 


PIA 少尉こと私は2000年の冬に 『1999 ChristmasEve 』 というテキストアドベンチャー•ゲ 
一 A を公開しました。 

ゲーム制作は初めてという素人集団を、ディレクシヨンは初めてという少尉が指揮して完 
成させた稚拙な処女作なのですが、ベクターデザインさんのサイトにアップした結果、2年間 
で150,000ダウンロードを突破するという望外な反響をいただきました。 


実はこのゲーム、「吉里吉里/ KAG 」 と呼ばれるフリーソフトのアドベンチャー•ゲーム 
作成ツールで制作させてもらつたのですが、ある日、当の「吉里吉里/ KAG 開発者」の 
W . Dee さんから一通のメールが舞い込んできました。 


W.Dee 

少尉は、僕よりも 「 KAGJ のことを知ってるでしょ 

少尉 

は、はあ （そんな わけないと思う けどなぁ？） 

W.Dee 

『1999 ChristmasEve 』 もとりあえず好評みたいだしね 0 

少尉 

お、おかげさまで。 

W.Dee 

というわけでお顕いなんです けど、「 吉里吉里/ KAGJ の 使い方を 全国のク 
リエ イターさん向けの原稿と して 書いて ぐれません？ 

少尉: 

:ぎょぇ！ \(><)/ 


少尉の恩人でもあり師匠でもある W . Dee さんの恩を裏切るわけにはまいりません。返事は 
一つでした。 

こうして少尉は、自分にそんな大役が務まるのかも半信半疑のまま、原稿執筆を承諾した 
のであります0 

少尉もまだまだ KAG 使いとしては半人前ですが、少しでも「本物の KAG 使い」を目指し 
て日夜 KAG のシナリオ • スクリプトと取り組んでいる皆さんのお役に立てれば幸いです。 

華麗なる21世紀のフルカラー対応 AVG & ノベル作成ソフトを目指して躍進を続ける「吉 
里吉里/ KAGJ を、今後ともどうぞよろしくお願いします。： 

横 浜かまいたちフアンクラブ代表 RA 少尉 筆 









吉里吉里 / ICAGti»u«^ ゲ - ム 8 作 

まえがき . 2 


基礎編 PIA 少尉 


AG を使う前に 


0-1 「吉里吉里/ KAG」 とは . "10 

0-2 KAG のプ□ジェクト • フォルダについて . 15 

0-3 Config.tjs を調整する . 18 

0-4「KAGJ と「タグ」と「属性」 . 30 


KAG 編 PIA 少尉 


AG の基本操作 


M 文字を表示する [l][p] [r][er] [cm] [ct].36 

1-2 背景画像を表示する [image]. 38 

1-3 BGM と効果音を鳴らす 

[playbgm] [stopbgm] [fadeoutbgm] [wb] [playse] [stopse] [ws].39 


^~~~ トランジション 


2-1 トランジシヨンの種類と原理 

[trans] [wt] [layopt] [backlay].44 

2-2 拡張トランジシヨン . 55 


Q 3 SEL 前景レイヤーを使ったキャラクター表示 


3-1 前景レイヤーを使ったキャラクター表示 . 60 


字表示のテクニック AG を使う前に 


4-1 フォント属性による文字装飾 [font] [resetfont] . . 72 

4-2 文字の表示速度 [delay] [nowait] [endnowait]. 73 

4-3 文字の位置表示 [locate] [style] [resetstyle]. 75 

4-4 KAG の文字配置座標について . 80 



























Iggpl 選赚とラベル 

5-1 選択肢とラベル . 

5- 2 ラベルとセーブ.ポイント"" . 

|§^ PI 変数の利用 

6- 1 KAG で取り扱える変数の形式 . . . 

6-2 数値変素 ... 

6-3 乱数の利用 • KAG で取り扱える変数の形式 
6-4 数値変数処理部のサブルーチン化 . 

6- 5 変数のイベント的な利用例 . 

^~~マクロを活用する 

7- 1 マクロの基本的な使い方 .. 

リッヵプル • マップの利用 

8- 1 クリッカブル•マップの作成方法 . 

8- 2 クリッカブル•マップを応用した CG ギャラリー 

の他の機能 

9- 1 スキップ状態を制限する . . . 

9-2 スタッフ□ールを作る . 

9-3 エンデイング.リストを作る ... 

9-4 制限時間つき選択肢を作る .. . .. 

9-5 ムービーを再生する [ video ] [ wv ] .. . 

9-6 右クリック動作のカスタマイズ . 

9-7 zoom プラグインの利用 . 

9- 8 雪•雨プラグインの利用 . 

UU ースに向けて 

10- 1 リリースに向けて ... 


8489 


85126 
9 0111 
I I-T T 


20 


3242 


24626791 
55566667 
T— T— Ti T T 11 T n— 


5 


74 

































TJS とは 


1-1 KAG と TJS. 190 

1- 2 TJS を学び始める準備 .. . 192 

iC 

2- 1 TJS 式とは ... 194 

2- 2 式の使い方 . 197 

Hello world! 

3- 1 まずは、コンソールから . 200 

3- 2 startup.tjs. 202 

変数 

4- 1 変数とは . 204 

4-2 var の使し、方 . 206 

4-3 変数の命名規則 .. …… . 207 

4- 4 データ型 .. .. 209 

5- 1 関数とは . 214 

5- 2 関数の作り方 . 217 

文法とスタイル 

6- 1 スタイル . 220 

6- 2 コメント . 223 

げ文 

7- 1 臨機応変なプ□グラム . 226 

7-2 条件式に使う演算子 . 230 


























スコープ 

8-1 変数のスコープ… . 236 

8- 2 関数のスコープ . 239 

While 文 

9- 1 While 文 . . . 241 

for 文 

10- 1 for 文 . 246 

switch 文 

1 M switch 文.. . 249 

オブジェクト 

12-1 オブジェクトとは 1 ? . 252 

12- 2 オブジェクトの種類. . . 253 

歹 11 

13- 1 配列 . 256 

13-2 辞書配列 . 258 

13- 3 配列のコピー.. .. 260 

クラス 

14- 1 クラスとは？. .. 264 

14-2 クラス内に記述するもの . 266 

14-3 オブジェクトの作成と削除 ... 267 

14-4 継承 . 270 


7 




























KAG の構造と動作 


15-1 吉里吉里/ KAG の構造と動作 . 276 

15-2 吉里吉里/ KAG の機能のアクセス . 279 


KAG 用プラグイン 


16-1 KAG のブラグイン . .……286 

16-2 吉里吉里/ KAG のトランジシヨンの動作 . 293 

1 6-3 雪プラグインを改造する .. .295 



FAQ . 302 

TIPS . 312 

CD - ROM の内容について . 326 

収録作獅介 . 328 

吉里吉里 / K AG 推進委員会の紹介 . 341 

演算？-胃 . 342 


あとがき 


355 


索引 


346 






















この章では r 吉里吉里/ KAGJ の紹介と、使う前 
に必要な最低限の準備について解説します。 
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KAG を使う前 I 


/ KAGJ とは 7 


「吉里吉里」は、 「 TJS 」 と呼ばれる独自のスクリプト言語を持つプログラ 
厶.エンジンです。 

「吉里吉 里」 は エンジン なので、それ単体では何もしませんが、動作命令 
を プログラムした 「 TJS スクリプト」 を与えて やる ことにより、 Windows 上で 
動作するさまざまな アプリケーションやゲームと して利用することができます。 

ただ、 TJS 自体は JavaScript に似ているとは言え、私のような プログラマー 
でな t ゝ一般庶民にはやや難しく感じられます。 


「プログラムを組むプログラマー」一これは、時代がいくら変わっても、モ 


ノを創ることを夢見るクリエイターの卵にとっては、憧れの対象であることに 
変わりありません。 

もちろん、プログラムがスイスイと書ければこんなに嬉しいことはありませ 
ん。「あんな効果」や「こんな演出」なども、「よ一し。おいらがチョチョイの 
チョイとプログラム書いて…」って、あなた、それが簡単にできれば誰も苦労 
はしません。 

たしかに、「 C ++」 * や「アセンブラ」 * などのプログラム言語を駆使すれば 
何でもできるでしょうが、言語の特性や命令•構文などを熟知しなくては、最 
初の一歩すら踏み出せません。また、「別にプログラマーになるつもりはない。 
楽をしてカッコ いい ゲームを作りたいだけだ」という人には、この壁はチョモ 
ランマのように高く聳え立つ人跡未踏の（しかも苦労してまで登ろうとは思わ 
ない）冬山にすぎません。 


そこで、 W . Dee 氏は、 TJS を使い、ゲーム制作に必要と思われる命令群を 
持つキットを作りました。これが 「 KAG 」 です。 

ちなみに、 KAG は「 Kirikiri _ Adventure _ Game _ system 」 の略であり、正式 
には 『 KAG システム』と呼びますが、ここでは便宜上 「 KAG 」 と呼ぶことに 
します。 

KAG で書かれたスクリプトは KAG で解釈された後に、 「 TJS 」 に引き渡さ 
れ、 「 吉里吉里」を アドベンチャー •ゲーム やノベル ゲームとして動作させる 
ことができます。 








0-1 「吉里吉里/ KAGJ とは？ 
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大切なことを言い忘れていましたが、「吉里吉里/ KAG 」 はフリーソフトです。 
フリーソフトはもちろん、市販品や同人作品など、お金を取るための作品に 
「吉里吉里/ KAG 」 を利用しても、 W . Dee さんにお金を払う必要はありませ 
ん〇 

さあ、あなたもこの無料にして最高のゲーム制作ツール『吉里吉里/ KAG 』 
を使って、あなたの胸に秘めた想いを形にしてみませんか？ 


r 吉里吉里/ KAGJ の自由度の高さ 


さて、私が吉里吉里/ KAG のどこに心底惚れ込んでいるかといえば、ひと 
えに「自由度と難易度のバランスが絶妙」な点です。 


普通、簡単なゲーム制作ツールは、簡単な故に制限が多いです。 

_たとえば、こんな感じですね0 _ _ 

• 同時に発音できる効果音は2つまで 
• 変数は全部で255個まで 
• 画像を表示できる最大数は3枚まで 


このように、“簡単操作”を謳う制作ツールに背後霊のようにくっついてい 
る「開発者の一方的都合による変な仕様」に泣かされたクリエイターも多い 
と思います。 

もちろん、この背後霊的制限は、操作性や制作工程を簡易化するためには 
非常に大切なことです。でも、でもでもでもですよ、あまりにも制限ばかり目 
に付いてしまい、「あれもダメ」「これもダメ！」って言われたら、親の束縛か 
ら逃避するために家出を敢行する中学生ではありませんが、「やってられっか 
よ！」って制作する意欲も失せちゃいますよね。 


私は「凝ったゲームを作りたい。でも、プログラムを勉強するほどじゃな 
い。だからといって、制限の多い簡易ツールは使いたくないなぁ」という一人 
でした。ですから、吉里吉里/ KAG に出会ったときには、心底驚きました。 

ツールがゲーム制作者に課す“制限”と呼ばれるものがほとんど存在しなか 
つ たのですから。 
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參暴春#參鬱 


ム g 义険 


KAG に惚れた惚 
れたと言いつつも、 
私には8つ年下の 
妻がおりまして、 
実は自称愛妻家な 
のです。 


* prontPageExpress 
MicrosoftGorporation 
のホームページ作成ソ 
フト〇 

* HomePageBuitder 
IBM のホームページ作 
成ソフト。 


「画像レイヤーを10枚使 t 、たい？ どうぞ」 

「変数を100個使い f こい？ 使う場所があれば、けっこうですよ」 

「選択肢の数を自由に増やしたり減らしたりしたい？ 問題ありませんわ」 
「セーブ•データの保存可能数を50個にしたい？まあ、 ユーザー 思いなこと 
ですね。もちろんかまいませんよ」 

「メニューをいろいろと変更したい？ 分かりました。システム的な部分も開 
放していますから、どうぞご自由に調整してください」 


まるで不可能という言葉が存在しな I ゝ辞書をもつ、明眸皓歯で才色兼備な 
完全無欠の美貌秘書（しかも物分かりが良い）のようではありませんか。 
こんな相手に惚れないわけにはいきませんでした。 


「吉里吉里/ KAGJ の敷居の低さと奥の深さ 


皆さんは、「制限が存在しないってことは、相当難解なスクリプトを学ばな 
いといけないんだろうなあ」と思っているでしょう。 

さにあらず。「吉里吉里/ KAG 」 は、初心者であっても取り扱いは簡単です。 

一判断として、 「 FrontPageExpress 」* や 「 HomePageBuilder 」* のような 
アプリケーションソフトを使わずに html を手書きできる人なら、 KAG を使っ 
てすぐにゲームが作れます。なぜ断定的な物言いができるかといえば、私自身 
がそうだったからです。 

もちろん、「吉里吉里/ KAG 」 を用いてゲームを制作する場合、「簡単作成 
ツール」などと銘打たれているソフトを使うより勉強量は増えます。でも、万 
能無敵な演出効果と美しい画像処理、そして開発者が涙するほどのきめ細や 
かなチューニング&カスタマイズ機能を目の当たりにすれば、あなたは絶対に 
「吉里吉里/ KAG 」 を手放したくなくなるでしょう。 

私自身、 最初は基本的な コマンド. タグ（命令）のみを使って ゲームの 骨 
組みを構築していました。初めて作ったものは、画面切り替えも変数処理も 
ない、ただ読ませるだけの絵本でした。 


— ^ 12 




0-1 「吉里吉里/ KAGJ とは? H ^| 


ですが、開発を進めていくにつれて演出に対する希望や要求が増えてきたの 
で、その場その場で実現したい演出に必要なコマンドを少しずつ勉強してきた 
のです。そして「吉里吉里/ KAG 」 は、見事にその要求に応えてくれました。 

つまり、最初にすべてを覚えるのではなく、自分に必要なコマンドを自分の 
ペースで段階的に学んでいけるのが、「吉里吉里/ KAG 」 の意外なウリでもあ 
り、開発者に対する優しさなのです。 

このように、「吉里吉里/ KAG 」 は、プログラムの書けないクリエイターに 
はうってつけのバランスの取れたスクリプト.ツールですが、バリバリとプロ 
グラムを書いている人にも朗報があります。 

「吉里吉里 J の上で動作する 「 KAG 」 は、前述した通り吉里吉里の専用言語 「 TJS 」 
で書かれているため、動作が気に入らなかったり、提供されていない機能を追加 
した t ゝ場合には、 KAG 自体を 「 TJS 」 レベルでカスタマイズすることが可能です。 

もちろん、わざわざ 「 KAG 」 をカスタマイズしなくても、オリジナルの 「TJS 
式」を 「 KAG スクリプト」内に書くことで TJS を使った演出は可能になりま 
す。背景画像の上に雪や雨など（好みによっては槍なども）を降らせたり、ク 
リッカブル•マップを使ったり、複雑な画面処理を行なったり…と、市販ゲー 
厶に実装されているたいて t ゝの処理は可能になります。 


「吉里吉里/ KAGJ の嬉しい仕様 


それでもまだ疑いの目で見ているお尻の重い人に、「吉里吉里/ KAG 」 の嬉 
しい仕様をアナウンスします。でも、全部を書くとページが無くなるので、少 
尉が感心した仕様や機能の一部について、簡単に書いておくことにします。 

①対応ファイル形式が豊富 

画像は現在流通しているほとんどの形式が取り扱えます。また、 BGM とし 
ては MIDI や OggVorbis * が指定できる他、音楽 CD トラックの利用もできま 
す。ミックス CD 形式で配布すれば、プロ顔負けのパッケージングも不可能で 
はありません。また、 Flash ムービーや MPEG など、新しく登場してくる主要 
なファイル形式についてはプラグインで随時対応しているので、エンジン自体 
がいつまでも陳腐化しません。 
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② トランジジヨン，パターンを自作できる 

ビジュアル命の萌えゲームや雰囲気を大切にする アドベンチャー. ゲームで 
は、トランジシヨン*もカッコよく行ないたいものですが、「吉里吉里/ KAG 」 
ではオリジナルのトランジシヨン.パターンを何種類でもゲーム内に取り込め 
る「ユニバーサル.トランジシヨン」と呼ばれる機能があり、 クリエ イター心 
をくすぐります。また、 「 KAG 」 には、用い方によっては絶大な視覚演出効果 
を期待できる「スクロール.トランジシヨン」と呼ばれる機能もあります。 

③ 制限のない変数とフラグ 

「吉里吉里/ KAG 」 では、「フラグ」「数値変数」「文字変数」をほとんど 
同様のオブジェクトとして取り扱うことができます。このため、それぞれの利 
用方法を別々に学ばなくても一貫した書式で自在に活用できます。また、変 
数の最大数や演算に制限は一切ないので、変数資源の枯渴を気にせず自由に 
利用することができます。乱数生成や自由演算はもちろん、論理分岐にから 
めて変数の増減を行なうこともできるので、市販の.アドベンチャー • ゲームに 
用いられているシステムを再現することも簡単です。 

④ デバッグが楽 

玄人向けのデバッガとモニタが搭載されているので、プログラム実行時にス 
クリブトがどのように解釈されているか、変数がどのように扱われているかを 
随時確認することができます。特に変数については、プログラム実行中に恣意 
的に任意の値を代入することが可能なので、変数分岐処理の確認やデバッグ 
に活用できます。慣れるまでは少し掛かるかもしれませんが、手に馴染みます。 

⑤ EXE 形式で配布可能 

完成したゲームは EXE 形式にリンク（結合）して配布できます。ランタイ 
厶もプレイヤーソフトも一切不要なので、ユーザーに「何だよ。これだけじや 
動かないのかよ！ だっせ一！」と失望感を味わわせることも少なく、何より 
ファイル1個でゲームが動いてしまうのが、市販ソフトみたいでカッコいいで 
はありませんか。 


看 14 







0-2 KAG のプロジェクト • フォルダについて 


0-2 


KAG 0プ〇ジ 3 C クト • フオ修ダに^ル VC 


.ノ 


「吉里吉里」のアーカイブ.ファイルには、「吉 
里吉里本体」の他に、吉里吉里をサウンドノベル 
やアドベンチャー. ゲームの エンジンとして動作 
させるための 「 KAG システム」（以後 「 KAG 」 と 
表記）が含まれています。 

KAG は右のようなフォルダ構造から成り立って 
いますが、このうち KAG の“本体”と呼べる部分は 
「 template 」フォルダ以下の10個のフォルダです。 

これらは、ゲームに必要な素材を入れておくた 
めのフォルダ群であり、これら10個のフォルダを 
全部まとめて 「 KAG のプロジェクト.フォルダ」 
と呼びます。 

デフォルトではプロジェクト • フォルダは 「 tern - 


白 Q kr 2 . 218 r 2 
白1こ] kag 3 
| 0 -Q kag 3 doc 

I E 3 -i_] kag 3 plugin 
^1 savedata 
| .£j syoukai 

.a US H P 

卜 [D bgimage 
| 卜 0 bgm 

卜 t_J fgimage 

| 卜 Q image 

| 卜… Q others 

j |-Q rule 

j 卜… Q scenario 

j 卜 i _1 sound 

I 卜"! __j system 

} L Q video 

i-Q kirikiri 2 


plate 」 という名前になっていますが、これはゲームのタイトルなどに自由に変 
更してかまいません。念のために別の場所に新しいフォルダを作り 、 template 
以下のサブフオルダをコピーして、そちらを開発に利用するとよいでしよう。 


template 以下のサブフオルダには、以下のような素材ファイルを入れます。 


•画像を入れるフォルダ 


bgimage 

背景絵 

fgimage 

キャラクターの立ち絵など、前景に表示する絵 

ima ^ 

イベント絵に代表される一枚絵など 

rule 

トランジシヨン用グレースケール画像ファイル 


• 音声や動画を入れるフォルダ 


bgm 

MIDU OggVorbis 形式の BGM 

sound 

Wave 、 OggVorbis 形式の効果音 

video 

AVI 、 MEPG 、 SWF 形式の動画 


r 吉里吉里」も 
「 KAG 」 も、 「 LZH 」 
と呼ばれる圧縮形 
式で配布されてい 
ますが、これはそ 
のままダブル•ク 
リックしても実行 
できません。まず 
は LZH ファイルを 
展開し、中身を取 
り出す必要があり 
ます。 

展開するには専 
用のアーカイバと 
呼ばれるソフトウ 
エアが必要ですが、 
これらはインター 
ネットのフリーソ 
フト紹介ページで 
無料ダウンロード 
できたり、雑誌の 
付録の CD - ROM な 
どに収録されてい 
るので、まずはそ 
れを手に入れまし 
よ9〇 

なお、圧縮ファ 
イルの取り扱いに 
ついては本書では 
特に説明しません 
ので、圧縮解凍の 
方法がわからない 
方はインターネッ 
卜や雑誌の付録 CD 
などで別途学習し 
てください。 


• 玄童を入れるフ オルダ 
^scenario kag のシナリオ子キストファイル 











KAG を使う前に 


•システム関係のフォルダ（追加や削除は不可） 
system f KAG の設定ファイル 




• その他のフォルダ_ 

厂 others 「 その他のファイル 


ゲームを開発し 


ている最中はプロ 
ジエクトの動作確 
認を行なう回数が 
非常に多くなるた 
め、最初からシヨ 
ートカットを作つ 
ておくと便利です。 


① krkr . eXe のシヨ 
一トカツトを作成 
します。 


この中でも開発中に頻繁にアクセスすることになるのが 「 scena rio 」 フォル 
ダです。 

scenario フォルダには、画面に表示する文章と各種の制御を行なうタグが書 
き込まれる 「 ks 」 という拡張子のファイルを置きますが、 KAG でゲームを制 
作するという行為は「このフォルダ内のシナリオ.ファイルを書く」という行 
為そのものに当たります。 


②このショートカ 
ットの「プロパテ 
ィ」を開くと、[シ 
ョートカット]タブ 
内にリンク先とい 
う項目があります。 
この末尾に半角ス 
ペースを空けてか 
ら、プロジェクト 
フォルダのフォル 
ダ名を、""で囲ん 
で書きます。 


つまり、 KAG でゲームを作る場合は、素材を準備して各フォルダに配置し、 
後はそれらを制御するためのシナリオ • ファイルを書くという手順で行なうわ 
けです。 


■開発環境を整える 




以降は、このシヨ 


一トカットをダブ 


ルクリックするだ 
けで指定されたプ 
ロジェクトが吉里 
吉里で動作します。 


プロジェクト.フォルダである template フォルダは、そのままでは実行でき 
ません。実行するには吉里吉里本体である 「 krkr . eXe 」 が必要になります。実 
行方法ですが、二通りあります。 


プロジェクト* 
フォルダが吉里吉 
里の実行可能ファ 
イルと違う場所に 
ある場合はプロジ 
ェクト • フォルダ 
名をフルバスで指 
定してください。 


① template フオルダを rkrkr . eXeJ のアイコン上にドロップする 

② 「 krkr . eXe 」 を起動して、実行プロジヱクトに template フォルダを指定する 


さらにこのシヨ 
トカットをスタ 


ここで間違えやすいのは、フォルダ/アーカイブの選択時に 「 startup . tjs 」 や 
「 first . ks 、 scenario 」 フォルダなどを指定しまうことです。これらのファイルや 
サブフォルダを指定してもエラーが返るだけなので、必ず template フォルダそ 
のものを指定（またはドロ V プ）する必要があります。 


登録しておけば、 
デスクトップ上の 
アイコンをダブ 
ノレ •クリックしな 


の Windows キーで 
すぐに起動できて、 
非常に便利です。 




0-2 KAG のプロジェクト • フオルダについて | 




基礎 


「 krkr . eXe 」 は開発の都合上、プロジェクト.フォルダと同じ階層に置かれ 
ていると便利なので、まずは kirikiri 2 フォルダ内に置かれている 「 krkr . eXe 」 
を template フォルダ（名前を変えて、別に作っている場合はそのプロジェク 
卜•フォルダ）と同じ階層にコピーしておきましよう。 

動作が確認できたら、いよいよ開発を始めますが、その前に、 template フ 
ォルダ内の sysytem フォルダの中にある 「 Config .~ new 」 という名前のファイ 
ルを 「 Config . tjs 」 に改名しておきます。これをせずにプロジェクト • フォル 
ダを 「 krkr . eXe 」 で実行しようとすると、エラーになります。 

x]| e-i _ 


f 


白 Ga オリジナルの作品だよ一ん 
i-H 1 bg image 
1--1 1 bgm 
j--Cl Tgimage 
j--i image 
i … 0 ] others 
I--Q rule 

scenario 
卜 ii] sound 
卜 Cj system 
::… Q video 


mT 


プロジェクト名のついたフォルダ 




ill ! 


_圍 
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へ I 
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费ザ V — 
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まず、マイコン 
ピュータを開き、 
「ツール」メニュー 
から r フォルダオ 
プシヨン」を選び、 
「ファイルの種類」 
タブをクリック。 
さらに「新規」を 
クリックし、拡張 
子の部分に tjs と入 
力して 「0 K 」 をク 
リック。 



「 Config . tjs 」 はそのままではダブル.クリックしても開けないので、拡張 
子が rtjsj のファイル形式を皆さんがよく使うテキスト•エディタに関連付け 
ておくとよいでしょう。 

「 Config . tjs 」 は、 「 KAG 全体の設定」「ウインドウや動作の設定」「メニュ 
一の設定」「メッセージ.レイヤーの設定」 「 BGM の設定」「メッセージ履歴 
表示の設定」——の6つのエリアに分かれていますが、ここでは順を追って変 
更が必要な場所を解説していきます。 

•全体の設定 


t 「吉里吉里」という文字をゲームのタイトルに直す。 


私はフリーのエ 
ディタ 「 TeraPad 」 
を愛用しています 
が、この場合は 
「アクションを実行 
するアブリケーシ 
ヨン」の部分に 
「 TeraPad . exe 」 を 
指定した後、半角 
のスペースを空け 
てから"％ 1" と記述 
する必要がありま 
す。 TeraPad を使 
う人は注意してく 
ださい。 


t 本書の解説通りに演習したいのなら、 「 false 」。 


けちなみに、ダウンロードしたばかりの template フォルダには 「 Config . tjs 」 と 
いうファイルは存在せず、代わりに 「 Confi g .~ new 」 というファイルがあるの 
ように 行ないます。 で、まずはこれを 「 Config . tjs 」 にリネームします。 



Conflg.t 相を調整する 


r r r / 


ソフトの定義ファイルなど普通の人は見ませんが、 “ KAG 使い”を目指すな 
ら、何が何でも 「 Config . tjs 」 を理解する必要があります。 


KAG を使う前に 

.■ へ ... ... ■.............. ハ... パ ハフ： . ..ダ. ノ : 


// ♦ タイトル 

//ウィンドウのキャプション（タイトル）および 
//タスクバーに表示されるものです。 

; System.title = "吉里吉里"； 


// ♦ シナリオ解析モード 

//シナリオファイル中の改行に従わせたい場合に false を設定します。 
// false を指定すると、 KAG のシナリオ中の改行が、行末に¥または 
// [P] を書かない限りそのままメッセージレイヤ上での改行として扱われ 
//ます。 true を設定すると [ r ] タグを書かない限り改行されません。 
// KAG 2. X 互換にするには false を指定してください。 

； global.ignoreCR = true ； 


子 c \ リクのリ 
張 DT をて下ク 
拡げ」れし右を 
tjs れけ探 ^ 
でさはらし妓 
れ録どかク_一。 
こ登んトツ#»ク 
がこスリ rP ッ 


リヨ入クがス実定らクを終 
クシとを分キの指すツグ定 
をク JJ 自テタをたリロ設 
J ア ell 哪て?7ィルひクア、 

規、 opr # し$9デイ、をイば。 
新し^—、ク價エアら一，ダれす 
r クに後ツく •フた DK てじで 
ツンカリよ卜行し ro し閉了 
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0-3 Config.tjs を調整する fpl 

IbaSmI 


•ウィンドウや動作の設定_ 

function KAGWindow_config() 

{ 

// ♦ 画面サイズ 

/ / scWidth に画面の幅、 scHeight に画面の晶さをピクセル単位で指 
//定します。標準的に使われている 64 0 x 48 0 や 800 x 600 のような画 
//面サイズではないサイズに設定すると、フルスクリーンにできない場合 
//があります。 

; scWidth = 640; 

一； scHeight 480 ;_ 

t 変更するとトラブルの元になります。 

// ♦ 読みとり専用モード 

// readOnlyMode = true とすると、ディスクへのいっさいの書き込み 
//動作をしなくなります。 CD - ROM 上から実行させるときなどに指定して 
// ください。もちろん、その場合は杲の保存などができなくなります。 

一 ; readOnlyMode 二— false ;_ 

t CD で配布し、セーブさせないデモ版などは 「 true 」 に。 

// ♦ フリーセーブ 

//呆の保存形式を指定します。 

// false を指定すると、メニューバーの「呆をたどる」「呆をはさむ」の 
//サブメニュー項目からセーブデータを保存したり読み込んだりします。 
//この場合は保存可能な呆の最大の個数は numBookMarks によって制 
//限されます。 

// true を指定するとフリーセーブモードになり、「栞をたどる」では 
// 「開く」ダイアログボックス、「呆をはさむ」では「名前を付けて保存」 
//ダイアログボックスが開き、杲を個別のファイルとして保存するモード 
//になります。この場合は保存可能な呆の個数に制限はありません。ま 
//た、エクスプローラなどによる呆の管理が容易になります。 

； rreeSaveDataMode = false ； 
t 通常は 「 false 」 のままでよい。 
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KAG を使う前に 


— g 丈居:抛飞现 


セーブデータ保 
存場所についてで 
すが、私の拙作1999 
ChristmasEve の場合 
は savedat という 
名前になっていま 
す。何でこんな名 
前に’したんだろう 
と、今となっては 
不思議に思います。 


// ♦サムネイルを保存するか 

// false を指定すると、セーブデータの拡張子は . kdt になり、サ厶ネ 
//イルは保存されません。 

// true を指定すると、セーブデータの拡張子は . bmp になり、 エ クスプ 
// ローラや「開く」ダイアログボックスの「縮小版」表示でセーブ時点で 
//のサムネイルを表示することができるようになります。 

； saveThumbnail = false ； 


t 通常は 「 false 」 のままでよい。 


// ♦ セーブデータ 保存場所 

// ； saveDataLocation = " savedata " ； 

//のように指定すると、吉里吉里の実行可能ファイルと同じフォルダ以下 
//の savedata フォルダにデータが保存されます。 

// ； saveDataLocation = System.personalPath + ••吉里吉里の 
// 呆7"、—夕"；； saveDataL 〇 cation = System.appDataPath + "吉 
//里吉里の杲データ”；のように指定すると、ユーザーごとのホームディ 
//レクトリ以下の”吉里吉里の杲データ"というフォルダのしたにデー 
//夕が保存されます。この場合は、例で示した"吉里吉里の呆データ" 

//の部分は他のゲームなどと重ならない、十分にユニークな名前である必 
//要があります。 System . personalPath の場合は通常「マイドキユ 
// メント」フォルダ、 System . appDataPath の場合は Application 
// Data になります。また、フリーセーブモードであってもシステム変数 
//やシステムの設定を記録するためにこのセーブデータ保存場所の指定は 
//必須です。詳しくは KAG 3 ドキュメントの「セーブデータに関して」を 
//参照してください。 

； saveDataLocation = " savedata " ; 


t 作品の略語にすると吉里吉里で制作された ゲーム 同士で重複しな t ゝため、変 
更すべき。 
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0-3 Config . tjs を調整する 


// ♦ データ 名 プレフィクス 

//ここ で指定した名前で始まる名前で罙関連の ファイルが 作成されます。 
//フリーセーブモードの 場合でも システム 変数や システムの 設定を保存する 
//ファイルに 影響します。 

一 ； dataName _= " data " ; __ 

t ここも作品の略語にする。 

(例： 「1999 ChristmasEve 」 の場合は 「1999 xe 」） 


// ♦ 文字表示スピード（ミリ秒/文字） 

； chSpeeds.fast =10 ; // 「高速』文字表示スピード 
； chSpeeds.normal =30; // 「普通」文字表示スピード 
; chSpeeds.slow = 50; // 「遅い」文字表示スピード 
t 通常はこのままでよい。が、速くするとユーザーが喜ぶ。 


// ♦ 通過記録の最大数 

//通過記録の最大数を指定します。最大、ここで指定した回数、前に戻 
//る事ができます。大きくするとセーブデータも大きくなります。 
;maxHistoryOfStore = 5; 

t 一つ上の「前に厌る」機能を使わない場合は「0」でよい。 


// ♦ 利用可能な効果音バッファの数 

//利用可能な効果音バッファの最大値を指定します。つまり、ここで指定 
//した数の分だけ効果音を同時に再生できます。効果音を使用しない場合 
/ V は0を指定してかまいません。 

; numSEBurfers 二 ^ ； 

t 通常はこのままでよいが、効果音を同時に2つ以上発音しなければ「1」で 
も足りる。 


効果音バッファ 
や前景レイヤー、 
メ ッ セージ レイヤ 
一などは必要最小 
限の数を定義して 
おくとメモリの節 
約になり、低スぺ 
ックのマシンでも 
動くようになりま 
す0 

私の場合は、前 
景レイヤーは「〇」、 
メッセーン•レイ 
ヤーは「1」の状態 
で Config . tjs に定義 
しておき、必要に 
なつたら [ laycount ] 
タグで増やし、使 
い終わったら減ら 
すようにしていま 
す0 

ただし、効果音 
バッファについて 
は Config . tjs 内でし 
か定義できないの 
で、注意してくだ 
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Step 


KAG を使う前に 



// ♦ 初期状態の前景レイヤの数 
//必要なければ〇を指定してかまいません。 

//数が多いと速度が低下したりメモリを消費しますので、必要以上に大き 
//な数を指定しない方が良いでしょう。 

// laycount タグでシナリオ内でも変更できます。 

； numCharacterLayers = 3; 

t 通常はこのままでよいが、前景を使わなければ「0」にしたほうがよい。 


// ♦ 初期状態のメッセージレイヤの数 

//前景レイヤと違って、0を指定することはできません。これも必要な数 
//だけ確保するようにすべきです。 laycount タグでシナリオ内でも変更 
//できます。 

; mimMessageLa_yers = 2 ； __ 

t 通常はこのままでよいが、普通に文字を表示するだけなら「1」でもよい。 


// ♦ 利用可能な呆の数 

// メニューに表示し、ユーザーが選択可能な呆の数です。 

// save や load タグで保存可能な呆の数はこの設定には影響しません。 
// メニューによる杲の管理を行なわない場合 （ ゲーム画面中で全部栞の 
//管理などを行なう場合など）は、 numBookMarks は必要な数に設定 
// し、 restoreMenu.visible と storeMenu.visible 江 raise v し 
// 設定してください。 

_; numBookMarks =10;_ 

t 作品内容に合わせて適宜変更。そこそこ多くするとユーザーは喜ぶかも。 


// ♦ 「ヘルプ '目次」を選択したときに実行するファイル 

//ここで指定するファイルは吉里吉里実行可能ファイルと同じ場所に設置 

//されていなければなりません。 

;helpFile = " readme . txt " ; 
t ヘルプ.ファイルの名前を拡張子まで含めて指定する。 
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//♦ 「システム > 前に戻る」 

;goBackMenuItem.visible _= true; _ _ _ 

t 作品内容に合わせて変更する。前に戻らせたくなければ、 「 false 」 に。 

// ♦ 「文字表示 > アンチェ7リアス」 

— ;chAntialiasMenuItem. visible = true ； __ 

t 通常はこのままでよい。 

// ♦ 一「文字表示 > フォント」 

; chChangeFontMenuItem.visible = true ; 
t ユーザーにフォントを変更させた くなければ、 「 false 」 に。 


// ♦ 「ヘルプ」 

； helpMenu.visible = true ； 


t 通常はこのままでよい。ヘルプが無ければ 「 false 」 に。 


// ♦ 「デバッグ」 

; debugMenu.visible 


false ； 


t 開発中は 「 true 」 に。リリースしたら 「 false 」 に。 


•メッセージ • レイヤーの設定 


function MessageLayer _ config () 

{ 

// ♦ メッセージ枠用の画像 

// メッセージ枠用の画像のファイル名を指定します。 

//"" を指定するとメッセージ枠の画像を使用しません。また、メッセ 
// —ジ枠用の画像を指定した場合、 position タグでメッセージレイヤ 
//のサイズを変更するとおかしな表示になると思います 
; f rameGraphic = "" ； // position タグの frame 属性に相当 


t メッセージ.レイヤーに枠をつけたい場合は、ファイル名を指定。 




いつも思うんで 
すが、どうして 
KAG の r デバッ 
グ•モード」はデ 
フオルトが 「 false 」 
なんでしようね。 




メッセージ 枠を 
使ったサンプルが 
CD に収録されてい 
るので、ご参考に 
どうぞ。 


0-3 Conflg _ tjs を調整する 




•メニュー<0設定 


リ字ャなと 
ィ文ジたこ 
ェ、{立の 
チはザ目能 
ンとギを機 
ア ー1 ザ}る 


ア場がい得さ逆のだ 
リたズしを小はるく 
イしイ美ン、合なて 
ェにサばイが場くし 
チ N 字れラすのく意 
。ン〇文け卜ま字に注 


- r スギ|すすアを、きゥれ文見、い 
アのギくでス合大アらいにでさ 
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KAG を使う前に 


1118 


政」 


画画 


アドベンチャー 
ゲーム風の画面に 
ついても、 CD に収 
録されているサン 
プルが有効だと思 
います。 


//令メッセージレイヤの色と不透明度 

// frameColor には OxRRGGBB 形式で （RR GG BB はそれぞれ2 
//桁の16進数）メッセージレイヤの色を指定します 。 f r ameOpac i ty 
// には〇〜 255 の数値で、不透明度を指定します。メッセージ枠用の 
//画像が指定されている場合は無効です。 

; frameColor = 0 x 000000； // position タグの color 属性に相当 
； frameOpacity =128； // position タグの opacity 属性に相当 


t 作品内容に合わせて色と不透明度を調整。 


// ♦ 初期位置 


//これらは、 position タクのそれぞれ left top width height の 
// 属性に対応します0 

； ml =16； // 

左端位置 

; mt =16; // 

上端位置 

；mw = 640-32 ; 

"幅 

；mh = 480-32 ； 

/ /局さ 


t この状態はノベル風の画面。アドベンチャー 
「 mt =400 mh =60」 などに変更する。 


ゲーム風にしたければ、 


// ♦ 文字の大きさ 
//デフォルトの文字の大きさ（高さ）を pixel 単位で指定します。 
； defaultFontSize = 24;_// deffont 夕7の size 属性に相当 


t 作品内容に合わせて変更する。 


// ♦ 行間 

//行間を pixel 単位で指定します。 

；defaultLineSpacing = 6; // def style タグの linespacing 

属性に相当 _ 一 _ 


t 作品内容に合わせて変更する。 







0-3 Config . tjs を調整する 


// ♦字間 

//字間を pixel 単位で指定します。 

//デフォルトは0で、正あるいは負のオフセツトで指定します。 

//負の数値を指定すると字間が詰まります。正の数値を指定すると時間が 
//空きます0 

；defaultPitch = 0； // defstyle タグの pitch 属性に相当 _ 

t 作品内容に合わせて変更する。 


// ♦ 文字の書体 

//デフォルトのフォント名を指定します。 

//この設定はシステム変数に記録されて、次回起動時に引き継がれるの 
//で、 userFace の設定を変更し、適用したい場合はシステム変数ファ 
//イル？？？？？ sc .kdt の " chdef aultFace " =>の行を削除してくだ 
//さい。カンマで区切って複数のフォントを指定することができます。そ 
//の場合は、最初の方に書いたフォントが存在すれば、優先されます。 

； userFace = " MS P 明卓月 "；// def font タフの face 属 1 生 v しネ目当 
t Windows 標準のフォントを使うことが原則。 


// ♦ 文字の色 

//デフォルトの文字の色を OxRRGGBB 形式で指定します。 

; def aul tChColor = Oxffffff ; // def font タグの color 属 ’ttt こ 

相当 _ 

t 作品内容に合わせて変更する。 


// ♦ 文字をボールドにするか 

//する場合は true , しない場合は false を指定します。 
;defaultBold = true ; / / def font タグの bold 属1生 t こネ目当 
t 作品内容に合わせて変更する。 


// ♦ ルビサイズ 

//ルビサイズを pixel 単位で指定します。 

; defaultRubySize = _10; // def font タクの rubvsize に彳日当 
t 作品内容に合わせて変更する。 


文字の窨体につ 
いてですが、自分 
が持っているフォ 
ントを指定しても、 
ユーザーの 中には持 
っていない人がい 
るかもしれません。 
普及率の少ないフ 
ォントならなおさ 
らです。できるだ 
け Windows 標準の 
フォントを使うか、 
自分で作ったオリ 
ジナルのレンダリ 
ング•フォントを 
利用するようにし 
てください。 
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KAG を使う前に 

:議總_鐘職 


f t ♦ ルビの表示オフセット 

//負の数を指定するとその pixel 数分、本文に近い位置に表示されます。 
;defaultRubyOffset = -2; // deffont タグの rubyoffset t こネ目当 
t 作品内容に合わせて変更する。 """ 


//令アンチエイリアス 文字描画をする か 
//する場合は true, しない場合は false を指定します。 
； defau 丄 tAntialiased = true; 
t 作品内容に合わせて変更する。 


// ♦ 影の色 

//影の色を OxRRGGBB 形式で指定します。 

; de f au 1 1 Shado wC o 1 o r = 0 x 000000； // deffont 5 勹 < T > shad — 

oweolor に属性に相当 _ 

t 作品内容に合わせて変更する。 


// ♦ 縁取りの色 

//縁取りの色を OxRRGGBB 形式で指定します。 

; defaultEdgeColor = 0 x 000000 ； // deffont ^ ^ (D edgecol - 

or I こ属こネ目当 _ 

t 作品内容に合わせて変更する。 


// ♦ 影を描画するか 

//する場合は true , しない場合は false を指定します。 

; def au It Shadow = true ; // deffont タグの shadow 属性に相当 

t 作品内容に合わせて変更する。 


// ♦ 縁取りをするか 

//する場合は true , しない場合は false を指定します。 KAG 3 から、 
//縁取りと影を同時に描画することができなくなりました。縁取りを指定 
//した場合は縁取りが優先されます。 

； default Edge = false ;— // def font タクの edge 厲性にネ目当 _ 

t 作品内容に合わせて変更する。 













0-3 Config.tjs を調整する 




// ♦ リンクの強調色 

//リンクを選択したときに出る半透明矩形のデフオルトの色です。 

一 ； defaultLinkColor = 0 x 0080 ff ; // link タクの color 属性に相土 
t 作品内容に合わせて変更する。 


// ♦ リンクの不透明度 

//リンクを選択したときに出る半透明矩形の不透明度です。 

;defaultLinkOpacity =64; _ _ 

t 作品内容に合わせて変更する。 


// ♦ 縦書きモード 

// メッセージレイヤを標準で縦書きモードにする場合は false ではなく 
// true を指定してください。 

_ ； vertical = false; _ // position タクの vertical 属性にネ目当」 

t このままだと横書き。縦書きにしたければ 「true」 に。 

• BGM の設定 

function BGM _ config () 

{ 

// BGM の設定です。 

// CD - DA , Wave , MIDI のいずれかを BGM として再生することができます。 
// ♦ BGM 再生メディア 

// type 変数に設定する文字列で、使用するサウンドバッファを決めるこ 
//とができます。 

/ / " Wave " : WaveSoundBuffer ( wav 等（プラグインで再生できる 

物も含む）） 

// "MIDI" : MIDIS 〇 undBuffer ( mid,smf ) 

// "CDDA" : CDDASoundBuffer ( cda ) 

_;type = " MIDI "; _ 

t このままだと [playbgm] で再生できるファイルは 「.mid」 になる。 「 OggVor - 
bisj を BGM に鳴らしたければ、 「MIDI」 を 「Wave」 に変更する。 




BGM に MIDI フ 
アイルではなく 
OggVorbis 形式を 
指定したい場合は、 
BGM 再生メディア 
の指定を MIDI から 
Wave に変更します。 

これによって 
OggVorbis が BGM 
として使えるよう 
になりますが、 
MIDI ファイルは使 
えなくなります。 
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「メッセージ履 
歴」とは、過去に 
画面に表示された 
文字を読み返すた 
めの機能で、吉里 
苦里2の『システ 
厶 j -•> 『メッセー 
ジ履歴の表示』を 
選ぶか、マウス • 
ホイールを上に回 
すと見ることがで 
きます。 



KAG を使う前に 


// ♦ CDDA 再生ボリュームラベル 

// " CDDA " を指定した場合は、 cdVolume 変数に、再生する CD のボ 
//リュームラベルを指定します0ボリュームシリアル番号ではありません。 
// KAG は、このボリュー厶ラベルを持った CD の挿入された CD-ROM ド 
//ライブで CD-DA を再生します。特にマシンに複数の CD-ROM ドライブ 
//が装着されている場合にこれを元にしてドライブの区別を行ないます。 

; cdVolume = " xxxx " ; 

t 音楽 CD を制御する場合は、その CD のボリューム.ラベルを書く。 

•メッセージ履歴の設定 
// ♦フォント名 
； font Name = "MS P 明朝"; 
t 作品内容に合わせて変更する。 


// ♦フォントを太字にするか 
； rontBold = true ； 
t 作品内容に合わせて変更する。 


// ♦ フォントのサイズ （pixel 単位) 
； fontHeight = 24; 
t 作品内容に合わせて変更する。 


// ♦ ラインの高さ 
__ ； lineHeight = 26; — 

t 作品内容に合わせて変更する。 


// ♦ 縦書きの場合は true 
； verticalView = false ； 
t 作品内容に合わせて変更する。 
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// ♦ ページ単位での閲覧を行なうかどうか 
//ページ単位での閲覧をするようになると 

// cm ct er タグ、あるいは repage 属性が true の hr タグ 
//でメッセージ履歴の改ページを行なうようになります。 
；everypage = false ； 
t 作品内容に合わせて変更する。 

// ♦ 自動改行を行なうかどうか 


; autoReturn = true ; 
t 作品内容に合わせて変更する。 









KAG を使う前に 


# 




0-4 


_ 論議.酬具 




「 KAG 」 は、「タグ」と呼ばれる命令を上から順番に並べていくだけで「吉 
里吉里」をゲーム•エンジンとして動作させるものです。このため、まずはこ 
れらのタグを理解することが先決です。 

タグの並べ方によっては高度な表現や演出が可能になりますし、逆に、思 
った通りに動作しないほとんどの理由はタグの書き間違いから生じるものです。 
このため、 「 KAG を使いこなす」ということは、 「 KAG に準備されているタグ 
使いこなす」ということになります。 


タグは以下のように書きます。 

•記述例 

[ er ] 

[image storage =" test . bmp " layer=base page 二 fore ] 


上のタグも、下のタグも、 KAG のタグです。上のタグは短くて覚えやすい 
ですが、下のタグはいろいろ書いてあってややこしそうです。 

このように KAG には、「タグのみで使えるタグ」（上の例では 「 er 」） と、 
「“属性”と呼ばれるパラメータを併記する必要があるタグ」（上の例では 
「 image 」） -の2種類があります。 

「タグのみで動作するタグ」は、 [] で挟んでそのまま書くだけですが、「属 
性をもつタグ」の場合は、以下のような書式に則って記述する必要があります。 

•記述例 

[タグ名（半角スペース）属性名=(半角イコール）属性のパラメータ] 


属性が複数存在する場合のタグは、さらに半角スペースを空けて「属性名」 
と「属性のパラメータ」を半角イコールで結んだものを記述します。 

なかには属性が10個近く並ぶような複雑怪奇なタグもありますが、最初は 
そんなものは無視してかまいません。 

少しずつ自分のペースに合わせて利用できるタグを増やして t ゝけるのも KAG 
の魅力です。 










0-4 「KAGJ と「タグ』 


■タグの書き方と2種類のモード 


実は KAG には2種類のタグの書き方があります。ひとつは 「 KAG 2」 までの 
書き方、もうひとつは 「 KAG 3」 から利用可能になった書き方です。例を見て 
みましよう。 

•「KAG2 互換モード」によるタグの書き方 

[image storage =" sample . bmp " layer=base page = rore ]¥ 


•「KAG3 モード」によるタグの書き方 

©image storage ^" sample . bmp " 丄 ayer=base page 二 fore 


上の 2 つのタグは同じ意味です。どちらでも使 t 、やすい方を使えば t ゝいので 
すが、私は古参の KAG ユーザーであることを除いても KAG 2 互換モードのほ 
うが使 t ゝやす t ゝと思っているのですが、それはタグ行の改行処理の違 t ゝに理由 
があります。 

「 KAG 2 互換モード」では、タグ行の末尾に半角の「¥」を記述することで、 
その行を非改行にすることができます。これは言い方を変えると、「その行を、 
画面上では存在しない行として扱うことができる」ということになります。 

たとえば、サウンドノベルの画面のように、文章が主体でその中にタグ行を 
記述した場合、 「 KAG 2 互換モード」では行末に半角の「¥」を置くか置かな 
いかで、その行自体を一行の空白に当てるか、それとも存在しない行として扱 
うのかが決められます。 

これは練習文です。 

[playbgm storage = ,, bgm . mid n ] ¥ 

さらに練習文が続きます。 


上のようなシナリオを書くと、以下のように画面表示されます。 
これは練習文です。 

さらに練習文が続きます。 

では、|¥」を外してみる1どうなるでしようか。 


と「属性 J im 


吉里吉里/ KAG 開 
発者の W . Dee 氏の 
話では、古くから 
の KAG ユーザー は [ 
] で挟む KAG 2 互換 
モードを、最近の 
ユーザーは KAG 3 
モードを好んで利 
用する傾向にある 
そうです。 


タグ行に記述す 
る記号はすべて半 
角です。アルファ 
ベットはもちろん、 
[] や¥などもすベ 
て半角で窨かない 
と動作しません。 







KAG を使う前に 



私の処女作品す 
ある1 999 Christmas - 
Eve がリリース中断 
して作り直しにな 
った直接原因が吉 
里吉里/ KAG の存在 
でした。 

ですので、私が 
吉里吉里/ KAG に出 
会ったのは1999年 
の12月頃になりま 
いね 0 _> 


これは練習文です。 

[playbgm storage =" bgm . mid "] 
さらに練習文が続きます。 


上のようなシナリオの場合は、以下のように画面表示されます。 
これは練！文です。 — 

さらに練習文が続きます。 


同じことを 「 KAG 3」 モードで行なおうとした場合は、次のようになります。 
これは練習文です0 — 

©playbgm storage =" Dgm . mid " 

さらに練習文が続きます o _ _ 


上のようなシナリオを書くと、以下のように画面表示されます。 
これは練習文です。 

さらに練習文が続きます。 


では、間に一行挿入する場合はどうしたらよいのでしょうか。 
これは練習文です。 

©playbgm storage = " bgm . mid " 

@r 

さらに練習文が続きます。 


上の例のように [ r ] タグを用いて強制的に空行を挿入しなければいけません。 


「 KAG 2 モード」と 「 KAG 3 モード」を比較してみればわかりますが、行末 
でタグが閉じていることを視覚的に理解できる方が html に似ていて馴染みやす 
いという理由もあるので、私は個人的に KAG 2 モードの方が好きです。 

このような理由と、私自身が古くからの KAG ユーザーであることから、こ 
の本では 「 KAG 2 互換モード」で説明させていただくことにします。 
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前項で説明した、 rtemplate 」 フオルダ内の「 system 」 フオルダの中にある 
「 Config . tjs 」 ファイルを変更すれば、 「 KAG 3 モード」から 「 KAG 2 互換モー 
ド」になります。 

この 「 Config . tjs 」 は KAG の動作を定義するための非常に重要なファイルで 
すが、開発者の W . Dee 氏の詳しいコメントが一緒に書かれているので 、 KAG 
を動かそうとする人はぜひ読んでみてください。 








_ 













KAG では、文字を表示させるために必要なタグはありません。書いた文字 
は、それだけで画面に表示されるようになります。 


「 scenario 」 フオルダの中にある 「 first . ks 」 というファイルを開いてみると、 
以下のようになっています。 

•シナリオ例 _ 

[wait time =200] 

★start | スタ—卜 
[ cm ] 

こんにちは。 


上の例の「こんにちは」の部分が画面に表示される文字です。文字はシナ 
リオ*ファイル内に書いていけばそのまま表示されますが、そのままだといろ 
いろと具合が悪いので、以下のタグを用います。 


n 

改行待ち記号を表示し、クリックまたはエンター • キーの入力を待つ。 

m 

改ページ待ち記号を表示し、クリックまたはエンター • キーの入力を待つ。 

M 

強制的に改行する。 


•シナ U 才例 


これを読んだら一旦停止。‘ [1] 

これも読んだら一旦停止。 [1] 

ここで強制的に改行 [ r ] してみます。 [1] 
更に改行 [ r ] してみます。 [1] 

この ページは ここでおしまい。 [ p ] 


基本的に、各行の行末には[1]*タグを用いて、次の行を表示させる前にいっ 
たん停止させます。次のクリックでページが切り替わる表現をしたい場合に 
は、最後の行末に [ p ] タグを使います。 

[1] タグも [ P ] タグも機能はほぼ同じで、画面に表示されるマークが違うだけ 
です。これらは自由にカスタマイズできます。 

ここで注意ですが、 [ p ] タグは改ページ処理そのものを行なうわけではあり 
ません。そもそも KAG には「ページ」という概念がないので、画面をクリア 











1-1 K AG の基本操作 


して次のページとして新たに文字を表示するためには、下記のタグのいずれか 
を使います。 


m 

現在の操作対象メッセージ • レイヤーをクリアし、文字属性をリセットする。 


すべてのメッセージ.レイヤーをクリアし、文字属性をリセットする。 


すべてのメッセージ•レイヤーをクリアし、文字属性をリセットした上に、操作 
対象レイヤーを messageO に戻す 0 


画面に表示されている文字を消すタグがなぜ3種類も用意されているのかと 
いえば、これは KAG が扱えるメッセージ • レイヤーの特性が理由になっています。 

画面上に表示する文字は「メッセージ•レイヤー」と呼ばれる透明なセルの 
ようなものの上に書かれますが、これは必要に応じて増やしたり減らしたりで 
きます。 

普通のサウンドノベルや電子小説を制作する場合は、デフォルトで指定され 
ている1枚で足りますが、少し凝ったことをしたいと思うと、1枚では足りな 
くなることがあります。このような環境下で文字を消す場合に、 [ cm ] や[出を 
使う必要が出てくるわけです。ただし、メッセージ•レイヤーを1枚しか使っ 
ていない場合は、 [ er ] タグで充分です。 


•シナ U 才例 


これを読んだら一旦停止。 

[1] 

これも読んだら一旦停止。 

[1] 

ここで強制的に改行 [ r ] してみます。 [1] 

更に改行 [ r ] してみます。 

[1] 

このページはここでおしまい。 [ p ] 

[ er ]¥ 


新しいページ。 [1] 


さらに続く。 [1] 


またページを切り替えようかな。 [ p ] 

[ er ]¥ 


更に新しいページ。 [1] 



[ er ] タグの後ろに半角の「¥」を記述しているため、 [ er ] の行は1行として見 
なされません。 [ er ] の行を空行にしたい場合は、 [ er ] の行末の「¥」を取ればそ 
の部分が空行になります。これでページの頭が一行だけ空きます。 
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•タグ記述例 

[_[image storage :" test 01」 bmp " layer=base page = fore ]¥ 

[ image ] タグには他にも数多くの属性がありますが、基本となるのは上の例 
に出てくる3つの属性です。 

「storage 属性」 表示したいファイル名を書きます。フォルダや拡張子は指 
定しなくてかまいません。 

「layer 属性」 背景画像を表示するレイヤー名である 「 base 」 を指定します。 

「page 属性」 「 fore 」 はフォアグラウンド、 「 back 」 はバックグラウンドの 
_意味になります。この場合は前面である 「 fore 」 を指定します。 

KAG で扱うレイヤーは、メッセージ•レイヤーであっても画像レイヤーであっても、 
すべてのレイヤーに裏表があります。なぜそれぞれのレイヤーに裏が必要なのかと 
いうと、画面切り替えに用いるトランジンョン効果(― Step2) を行なう場合、切り替 
わる先の画像をレイヤーの裏側に準備しておく必要があるからです。 

このため、フォアグラウンドに画像をロード ( page = fore ) すれば画像は即 
座に表示されますが、バックグラウンドにロード ( page = back ) した場合は卜 
ランジシヨンをしないと見えません。 


•シナ U 才例 _ 

[image storage =" testOl . bmp " layer=base page 二 fore ]¥ 
[ er ]¥ 

背景を表示してみました。 [1] 

見えますか？ [1] 

[image storage =" test 02 . bmp " layer 二 base page = fore ]¥ 
背景だけ入れ替えてみました。 [1] 

ちゃんと入れ替わったかな？ [1] 

もういっちょ〇 [1] 

[image storage =" test 01 . bmp " layer=base page = fore ]¥ 
[ er ]¥ 

1 枚目に戻してみました。 [1] 

^ついでに ページ も切り替えてみました。 [1] _ 


文字を表ボさせるたけでなく、文字の背後に画像を読み込むには、 [ image ] 
タグを使います。 


背鼉画像奄賽示する [image] 


KAG の基本操作 


ge 名拡クを 
ra ル，.ン 


ど索ル別更るけてをテでてと 
ほ検イて変あだめらークけい 


stc ィ時ルョ-。後でァしにもる含れ才 I つよ 
i ァるブシ St ' 名フ換ル合きでそクマをが 
でフすダーきしル、 a ィ場でま、.ン癖方す。 
g に定やテでだィり括ァい，子しルョるたま 
KA 性指子 I 略たァた|フたで張記ブシくいい 
属を張才省フしをのしの拡表ダーくお思 
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BGM と効果音を鳴らす [playbgm] [stopbgm] [fadeoutbgm] [wb] [playse] [stopse] [ws] |[#aTc1 



BGM と効果音 t 鳴らす [playbgm】[stopbgm] r j 
[fadeoutbgm] [wb] [playse] [stopse] [ws] 


ゲームに BGM と効果音は必須ですが、これらはそれぞれ 一つの タグを書く 
とによって手軽に再生することができます。 


{playbgm] 

BGM を再生する。 

[sto|^>gm] 

BGM を停止する。 

tfadeoutbgm] 

BGM をフェードアウトする。 

_ 

BGM が鳴り終わるのを待つ。 

(playsej 

効果音を再生する。 

[stopse] 

効果音を停止する。 

tws] 

効果音が鳴り終わるのを待つ。 


•シナリオ例 

[ er ]¥ 

今から BGM を流してみます。 [1] 

[playbgm storage ^" test . mid "]¥ 

鳴っていますか？ [1] 

では止めてみましよう。 [1] 

[ stopbgm ] ¥ 

いきなり止めると気分が悪いですね。 [1] 

もう一度鳴らしてみます。 [1] 

[playbgm storage 二' , test . mid " ] ¥ 

今度はフェードアウトさせてみますね。 [1] 

[fadeoutbgm time =3000] ¥ 

3000 ミリ秒、つまり3秒でフェ ー ドアウトしました。 [1] 

更に、もう一度鳴らしてみます。 [1] 

[playbgm storage 二" test . mid " ] 蛤 
もう一度、 フェードアウト。 [1] 

ただし、今度のは、フェードアウトが終わるまで次の文字を表示しません。 [1] 
[fadeoutbgm time =3000] ¥ 

[ wb ]¥ 

はい。ご清聴ありがとうございました。 [1] 

[ er ]¥ 

続いて効果音のテストです。 [1] 
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1-3 BGM と効果音を鳴らす [playbgm] [stopbgm] [fadeoutbgm] [wb] [playse] [stopse] [ws] 

. … ：■：：；；：•：""..... . . • * 

•着 _ • 

ここまでの例では、「メッセージ.レイヤー〇」が画面全体に覆いかぶさるよ 
うなタイプを用いてきましたが、アドベンチャーゲームやビジュアル系のノべ 
ルゲームに見られるような、画面の下部のみに細いメッセージ.レイヤーを表 
示させることもできます。 

これは fConfig . tjsJ を書き換えることで可能になります。 


• Config.tjs 例 

function MessageLayer _ config () 

{ 

// ♦ メッセージ枠用の画像 

； frameGraphic = "" ; 7/ position タグの frame 属性に相当 


// ♦ メッセージレイヤの色と不透明度_ 

； f rameColor = 0 x 660088； // position タグの color 属性に相当 

t デフオルトは「000000」で黒。ここでは「660088]にした。_ 

; frame 〇 pacity =170; // position タクの opacity 属性 I しネ日当 

t 透明度を調整。 


// ♦ 左右上下 マージン 
；marginL =20; // 左余白 
;marginT = 8; // 上余白 
;marginR =8; // 右余白 
;marginB =8; // 下余白 
t 文字の表示される位置を調整。 


// ♦ 初期位置 


； ml = 

40; 

// 

左端位置 

;mt = 

340； 

// 

上端位置 

；mw = 

560; 

// 

幅 

；mh = 

120; 

// 

高さ 


t メッセージ.レイヤーそのものの位置を調整。 



一例として上記のように設定した 「 Config . tjs 」 を用いると、メッセージ- 







KAG の基本操作 


レイヤーは画面の下部に表示されるようになります。基本操作が理解できた 
ら、作りたいゲームのデザインに合わせてメッセージ.レイヤーを変更してお 
くとよいでしょう。 



_ KAG は、ビジ〇アルノベルやサウンドノベルのような 
I ノベル系ゲームや、選択肢を選んでストーリーが進む 
I ような文字ベースのアドベンチャーゲームを作成する 
I ためのキットです。 

P KAG は吉里吉里をゲームエンジンとして動作させる 
N ためのスクリプトで、それ自体は TJS スクリプトで書かれ 
ています。 KAG 用のスクリプトは「シナリオ j と呼ばれ、 
TJS スクリプトとはまた別のものです。 TJS スクリプトはプ 
j ログラミングの知識がかなり必要になりますが、シナリ 
I 才はより簡単で記述しやすいものです 。 v 



吉罜吉罜 


このようにメッセージ枠の中にメッセージを表示させ 
ることもできます。アドベンチャーゲームで良くある夕 
イプです。 


全画面表示の例 


アドベンチャー風の例 



















トランジシヨン 



• ••### 


[ ws ] や [ wb ] と同 
様、処理が完全に 
終了するまで待つ 
ためのタグは wait 
の頭文字を取った 
[ w _] で始まること 
が多いようです。 


QQI トランジシ 3 ンの麵と顧 

[trans] [wt] [layopt] [backlay] 

「トランジシヨン」とは、メッセージ•レイヤーに書かれた文字や画像レイ 
ヤーに表示されている画像を別のものに入れ替えるときに使う機能ですが、 
KAG で提供されているトランジシヨンには以下の4種類があります。 

①クロスフェード • トランジシヨン ©ユニバーサル. トランジジョン 




③ スクロール • トランジシ ヨン ④拡張トランジシ ヨン 




この中で基本となるのは|クロスフヱード.トランジシヨン」ですが、この 
トランジシヨンの原理を理解してしまえば、他の3つのトランジシヨンについ 
てもほぼ同様に扱えます。 

なお、タグの使い方は4つのトランジシヨンで共通なので、一度覚えてしま 
えば他のトランジシヨンでも応用できます。 

トランジシヨンを行なう場合に使うタグは、 [ trans ] [ wt ] の二つです。 [ trans ] 
はトランジシヨンを行なうタグで、 [ wt ] はトランジシヨンが完全に終了するま 
で次の行を実行しないように終了を待たせるタグです。 
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トランジシヨン 


_ 

馨 


うよ〜。消えちゃうよ〜。 [1] 

[wt ] ¥ 

[ er ]¥ 

あのように消えてしまうのは変なので、 trans タグと wt タグはセットで 
使うことをお勧めします。 [1] 


上のサンプル.シナリオでは、メッセージ.レイヤーはそのままの状態で 
base レイヤーの画像をトランジションさせました。 

ですが、画像が切り替わる瞬間をもっとはっきり見せた t ゝ場合もあると思い 
ます。このような場合は、以下のような考え方をします。_ 

① メッセージ.レイヤーを非表示にする。 

② base レイヤーのみ表示されている状態で画像をトランジション。 

③ メッセージ•レイヤーを再表示する。 


メッセージ. レイヤーを非表示にすれば、当然その上に書かれている文字も 
不可視状態になりますが、 base レイヤーの背景画像がトランジションしている 
間だけなので、問題はありません。 

ここで利用するタグは、レイヤーの各種属性を設定する [ layopt ] タグです、 


[ layopt ] には 「 layer 」「 page 」「 visible 」 その他の属性があります。この中の 
visible 属性を 「 false 」 にすると layer で指定されたレイヤーが不可視になりま 
す。常用しているメッセージ•レイヤーは 「 messageO 」 なので、下のように 
書きます 。 

•タグ記述例 

• 非表示にする場合 

[layopt 丄 ayer=messageO page=rore visible = false ] ¥ 


•再表示する場合_ 

[layopt layer=messageO page=fore visiDle = true ]¥ 


の記述を先ほどのサンプル • シナリオに組み込んでみます。 
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トランジシヨンの種類と原理 



_ _曇## _馨 


•シナリオ例 __ 

[er]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage="testOl.bmp" layer^base page=forej¥ 
バックグラウンドに画像を表示。 [1] 

[image storage^"test02.bmp" layer=base page=back]¥ 

メッセージレイヤー 0 のフォア、バックともども非表不にしてから、トラン 
ジシヨンします。 [ 1 ] 

[layopt layer=messageO page=rore visible=falsej ¥ 

[layopt layer=messageO page=back visible=false]¥ 

[trans method=crossfade time=2000]¥ 

[wt] ¥ 

[layopt layer=messageO page=fore visible=true]¥ 

メッセージレイヤー 0 を再表示しました。 [ 1 ] 


「メッセージ•レイヤー0」のバックグラウンドを非表示にする理由は、卜 
ランジシヨンの原理と関わっています。 

トランジシヨンはすべてのレイヤーのバックグラウンドに存在するデータや属性を 
フォアグラウンドへ持ってきてしまうので、「メッセージ•レイヤー0」のフォアグ 
ラウンドをいくら不可視にしても、バックグラウンドが可視状態では意味があ 
りません。このため、両方のページを不可視にしておく必要があるわけです。 


■ vmn 


•ジ • レイヤーのトランジシ: 


[ layopt ] タグを使ってメッセージ.レイヤーを制御するだけでは、パッと消 
えたりパッと現われたりするだけで味気がないと思うかもしれませんが、当然 
こちらにもトランジシヨンを用いることができます。 


考え方は、非表示にしたいメッセージ.レイヤーのバックグラウンドをまず 
不可視にし、トランジションを行なって不可視属性のバックグラウンドを文字 
の書かれているフォアグラウンドに転送します。 

こうして見えないものをバックグラウンドから転送したために、フォアグラ 
ウンドの文字や文字枠はトランジション効果によって、消えます。 

このような時に必要なのが、 [ backlay ] タグと呼ばれるタグです。これはフォ 
アグラウンドの属性をバックグラウンドにコピーする働きを持っています。卜 


各レイヤーが持 
つ裹ページ ( page = 
back ) は、演劇な 
どの舞台裏に似て 
います。 

お客さんから見 
える場所 ( page = 
fore ) では俳優が演 
技をしていて、見 
えない舞台裏 
( page = back ) では 
役目を終えた俳優 
が一服したり、次 
のシーンの準備を 
したりしているわ 
I けです。 _ J 
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トランジシ 3 ン 




ランジシヨン前にこのタグを用いて、全レイヤーの表画面の情報を裏画面にコ 
ピーしておきましょう 



base 薄} 
何もなし 
表から画像 A が 
コピーされたが 
どうせ見えない 

base {表） 
画像 A 表示中 

画像 A 表示中 

messag 00 *_)s 

何もなし 
表から文章がコ 
ピーされたがど 
うせ見えない 

文章表示中 

文章表示中 

画像 A 表示中 

画像 A 表示中 

不可視状態にな 
り文字と文字枠 
が消える 

文章表示中 

画像 A 表示中 

画像 A が裏から 
コピーされるが 
見た目は変化なし 

不可視状態 

不可視状態が裏 
からコピーされ 
て文字と文字枠 
が消える 

画像 A 表示中 

画像 A 表示中 

不可視状態 

不可視状態 



さらに、後半の「メッセージ • レイヤー0」の再表示についてもトランジシ 
ンで行なうことができます。 


M で文字レイ 


Payopt ] でメッ 
セージレイヤー 
4 の裏醑固を可視 
状 饑に戻す 
prans ] タグで 
裏画面の内容を 

__圏___ 

ノ T ^ K 

麵終 "F 





画像 B 表示中 

画像 B 表示中 

不可視状態 

不可視状態 

画像 B 表示中 

画像 B 表示中 

不可視状態 

レイヤーをリセ 
ットし、文字枠 
復帰 

画像 B を表画面か 
ら コピーす るが、 
同じ画像だし、 
どうせ見えない 

画像 B 表示中 

リセット状態の 
属性を表画面か 
ら コピーし てく 
る 

リセットされた 
不可視状態 

画像 B 表示中 

画像 B 表示中 

可視状態に 

不可視状態のまま 

画像 B 表示中 

裏画面から画 
像 B が コピー 

可視状態 

裏画面から可視 
属性が表画面へ 
□ー ド、 

画像 B 表示中 

画像 B 表示中 

可視状態 

可視状態 
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•シナリオ例 __ 

[er]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage="testOl.bmp" layer=base page=rore]¥ 
フォアグラウンドのデータと属性をバックグラウンドへコピーします。 [1] 
[backlay]¥ 

続いて、メッセージレイヤー 0 のバックグラウンドを不可視状態にします。 [1] 

[layopt layer=messageO page=back visible=ralse]¥ 

それでは、トランジシヨン。 [1] 

手を触れないで待っていてくださいね。 [1] 

[trans method=crossfade time=3000] ¥ 

[wt]¥ 

ここで文字が見えなくなりましたが、シナリオは続きます。 
バックグラウンドに画像を表示して、背景のトランジシヨン。 

[image storage="test 02 .bmp" layer=base page 二 back]¥ 

[trans method=crossfade time=3000]¥ 

[wt]¥ 

[ct]¥ 

[backlay]¥ 

Llayopt layer=messageO page 二 back visible=true]¥ 

[trans method 二 crossfade time 二 300 0]¥ 

[wt ] ¥ 

[er]¥ 

メッセージレイヤー 0 を再表示しました。 [1] 


ただしこの例だと 3 秒のトランジションが 3 連発になってしまうので、ユー 
ザーは 1 シーンの切り替えに 9 秒も待たされることになります。 

ゲーム全編を通して一度や二度なら許されるかもしれませんが、毎回この状 
態が続くのは困りものです。プレイする人の気持ちを考えて、バランス良く利 
用するとよいでしょう。 



'ハ； 








ウェイトばっか 
りのゲームはか 
したるいですよね。 


___ 
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議:_ 


二.::て::'::. 

:. 

実は [ trans ] タグ 
には children とい 
う属性があり、 
children=false とす 
ると base レイヤー 
の内容だけが ト ラ 
ンジシヨンされま 
す0 




« 


■ base レイヤーのみのトランジシヨン 


先ほどまでの例とは逆に、こんどはメッセージ.レイヤーはまったく操作せ 
ず、 base レイヤーに表示されている画像だけを入れ替えてみます。 

先にも述べたように、 [ trans ] タグはすべてのレイヤーのバックグラウンドに 
あるデータや可視不可視の属性をフォアグラウンドに持ってきてしまいます。 
たとえそれが持ってきてほしくないものであっても、バックからフォアに、強 
制的に持ってきてしまいます。それを擬似的に回避するため、 [ backlay ] のよ 
うなページ間コピー用のタグが準備されているわけです。 

base の back に新しい画像を読み込んでトランジションさせたい場合、 「 mes - 
sageOj の back がもし空っぽだったら、トランジションを行なうと、背景は入 
れ替わりますが、文字は消えてしまいます。つまり、メッセージ.レイヤーを 
いじらずに、背景だけ入れ替える作業をするには、ちょっとした工夫が必要に 
なるのです。 

処理手順につ t ゝては次のようになります。 


1 麵前の機 
褰蘭爾の!^容 

2を 〖 backlay ] で 
裏 画面へコピ- 
pmage ] で躕像 
B を背景レイ 
" ヤーの裏画面 
にロード 



何もなし 

表から画像 A が 
コピー された 

画像 A 表示中 

画像 A 表示中 

何もなし 

表から文章が 
コピー された 

文章表示中 

文章表示中 

画像 B をロード 

画像 A 表示中 

文章表示中 

文章表示中 

画像 B 表示中 

画像 A から日へ 

文章表示中 

back から文章 
がトランジシヨ 
ンされるが同一 


トランンシヨン 


内容のため見た 
目は変イ匕なし 

画像 B 表示中 

画像 B 表示中 

文章表示中 

文章表示中 



このように [ trans ] タグでトランジションを行なうときに「メッセージレイヤ 
一0」に変化が起きていないように見せるには、 [ backlay ] でフォアグラウンド 
から バック グラウンドに同じ データをコピーして おけばいいのです。これによ 


述がモすき 
記置メ用で 
の算、使め 
こ演りに勧 
しとな駄お 
だぅに無でん。 
た行大をのせ 

を膨リるま 
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ってトランジシヨン時にバックグラウンドからフォアグラウンドへデータが転送 
されても、結局は同じものが行ったり来たりしているだけになります。 

ただ、気をっけなければならないのは、 [backlay] を使うタイミングです。画 
像 B をロー ドした後に [backlay] を使ってしまうと、せっかくバックグラウンド 
にロー ドした画像 B が、 [backlay] のおかげでフォアグラウンドにあった画像 A 
に戻ってしまいます。 

トランジシヨンが意図どおりにいかないのは、この [backlay] タグの使い方を 
間違えているケースが非常に多いです。 

❿シナリオ例 

[ er ]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage =" testOl . bmp " layer=base page = fore ]¥ 
backlay タグを使ってメッセージレイヤー0のフォアグラウンドのデータと 
属性をバックグラウンドへコピーします。 [1] 

base レイヤーの画像もフォアからバックへコピーされますが、次のステッ 
プで新しい画像をバックに口ードするので気にしなくていいです。 [1] 

続いて、バックグラウンドに新しい画像を口ードし、トランジシヨンしてみ 
ます。 [1] 

[ backlay ] ¥ 

[image storage =" test 02. bmp " layer=base page = back ]¥ 

[trans method=crossfade time =3000]¥ 

[wt ] ¥ 

文字がそのままで、背景画像だけが入れ替わったように見えましたか？ [1] 


:バーサル • トランジシ 


「ユニバーサル. トランジシヨン」は“汎用的なトランジシヨン”という 意 
味で、「ルール•ファイル」と呼ばれるファイルを自作することによって、無 
限のトランジシヨン.パターンを利用することができます。 


クロスフヱー ドでは、画像は単純な フヱー ド効果によって切り替わっていま 
したが、ユニバーサル. トランジションはこの ルール•ファイルの パターンに 
従って切り替わるためです。 


[ backlay ] タグが 
自在に扱えるよう 
になったら KAG 中 
級者ですね。 


ルール•フアイ 
ルは KAG の rule フ 
オルダに入れて使 
いますが、フアイ 
ル形式はグレース 
ケールの PNG ファ 
イルでなければな 
りません。 
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属性 「 vague 」 は初めて見ると思いますが、これはユニバーサル.トランジ 
シヨン専用の属性です。数値は境界のあいまい値を表しており、この値が小さ 
いとトランジシヨンはくっきりと行なわれ、大きいとぼんやりと行なわれます。 
通常は100程度にしておき、シャープな切り替えをしたければ数値を下げ、フ 
ァジーにしたければ数値を上げるとよいでしょう。 

春シナリオ例 


ユニバーサルト 
ランジシヨンを利 
用するときに指定 
する属性 method = 
universal は省略で 
きます。 

省略するとュニ 
バーサ ルトランジ 
シヨンが自動的に 
設定されたことに 
なるからです。 

method = を指定 
する必要があるの 
は、クロスフ エー 
ド ト ラン ジシ ヨン 
や後述のスクロー 
ルトランジシヨン 
を利用するときだ 
けです 


[er]¥ 

背景画像を base レイヤーに表示 。 [ 1 ] 

[image storage 二 " test 01 .bmp" layer 二 base page 二 fore]¥ 

続いて新しい画像を base レイヤーの裏ページへ読み込み。 [1] 

[image storage^"test 02 .bmp" layer 二 base page=back]¥ 

それではトランジシヨンします。ブラインド風のトランジシヨンです。 [1] 

[trans method=umversal rule = " ruleO 1 .png" time = 3 000 
vague=100]¥ 

[wt ] ¥ 

別のルールファイルを使ってみましようか。 [1] 

[er]¥ 

もう一度もとの画像を base レイヤーに表示 。 [ 1 ] 

[image storage^"testOl.bmp" layer=base page=fore]¥ 

続いて新レい画像を base レイヤーの裏ページへ読み込み。 [1] 

[image storage="test 02 .bmp" ユ ayer=base page=back]¥ 

今度は円形のトランジシヨン。 [1] 

[trans method=universal rule="rule02.png" time = 3 000 
vague=100]¥ 

[wt ] ¥ 

ルールファイルのファイル名をいろいろ変更して試してみてください。 [1] 




トランジシヨン 


_ 


•タグ記述例 


[trans method=universal rule="ruleO 1 .png ' 
vague=100]¥ 

[wt ] ¥ 


time = 3 0 00 


あをフなま 
に値スらい 
I 性数口わま 
属なク変し 
ue きととて 
g 大るドつ 

va りれ一な。 
ま入Xくす 
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2-1 トランジシヨンの種類と原理 


ルールフテイルは 「 syokai 」 フォルダの中に2つ入っている他、 CD - ROM 内 
に収録されているトランジシヨン.ライブラリ （ translib 2.1 zh ) にもたくさん 
入っています。 

最初のうちはライブラリのファイルを利用しておいて、表現力が不足してき 
たら自作するとよいでしょう。 


■スクロール • トランジシヨン 


「スクロール.トランジシヨン」 は、その 名の通り画像をスクロール させて 
表示するためのものです。 

•タグ記述例 

[trans method 二 scroll time=：5000 from=left stay=stayfore]¥ 
[wt ] ¥ 

from 属性は方向を表わします。 「 left 」「 right 」「 top 」「 bottom 」 の 4 種類が 
あるので、演出効果を考えて方向を指定します。 

また、 スクロール. トランジシヨンは1種類のトランジシヨンですが 、 stay 
属性を変更することによって3種類の表現ができるようになっています。 


• stay=stayfore 

表画面の画像の上に、裏画面の画像が from で指定した方向から入ってくる。 

• stay=stayback 

表画面の画像が from で指定した方向へ出て行き、裏画面の画像がその下か 
ら見えてくる。一般の紙芝居の形式。 

• stay=nostay 

表画面の画像が出て行くと同時に裏画面の画像が入ってくる。このため 二 
枚の画像が連結されて動 V ゝているように見える。 


特に演出効果として優れているのが、 「 stay = nostay 」 で利用した場合です。 
画面の2倍のサイズに該当する横長または縦長の画像を用意し、それを半 








トランジシヨン 


m 


トランジシヨン 
の種類と必要な属 
性について整理し 
てみると、以下の 
ようになります。 

ク □スフ エー ド' 卜 
ランンンヨン 

method time 

ユニバーサル トラ 
ンジシヨン 

rule time vague 

スクロールト ラン 
ジシヨン 

method time 
form stay 


分に切って 2 枚に分けて準備しておけば、 スクロール. トランジシヨンを用い 
ることによって視点を移動させるような効果を出すことができます。 

•シナ U 才例 

[er]¥ 

フォアグラウンドに画像を表示。 [1] 

[image storage="scrol 丄 testOl.bmp" layer=base page=fore]¥ 
見えませんけど、バックグラウンドに画像を表示。 [1] 

[image storage:"scrolltest 02 .bmp" layer 二 base page=back]¥ 
スクロールト ランジシ ヨン。 [1] 

[layopt layer=messageO page=back visible=false]¥ 

[layopt layer=messageO page=fore visible=false]¥ 

[trans method 二 scroll time=3000 from=bottom stay=nostay]¥ 
[wt ] ¥ 

[layopt layer=messageO page=fore visible=true]¥ 

視点の移動効果が出ていますか？ [1] 









2-2 拡張トランジシヨン | 


拡張トランジシヨン 


「拡張トランジシヨン」は、吉里吉里のプラグインを利用することによって 
行なうことが可能なトランジシヨンです。 

利用するためには、 krkr 218 フオルダ内にある plugin フオルダの中の 
「 extrans . dll 」 ファイルを、 「 krkr . eXe 」 と同じ場所にコピーする必要があります。 

現在のところ、拡張トランジシヨンには6種類のハンドラが準備^れています。 
これらを切り替えることによって、さまざまなトランジシヨンが利用できます。 


wave 八ンドラ 


mosaic 八ンドフ 


プラグインとは、 
本来のプログラム 
とは別の状態で配 
布されている追加 
プログラムのこと 
ァオ 

これを本来のプ 
ログラムに追加す 
ることによって、 
本来のプログラム 
が持つ機能を拡張 
することができま 
す0 

要するに、ロボ 
ットの拡張パーツ 
みたいなものです 
ね。空を飛ぶ羽と 
か、地中を進むド 
リルとか。 


turn ハンド : 


、 v 

\\、 颇域良. II ’ 

\\、議鶴擊％ 


「 otatezoom ハントフ 


rotatevamsh ハン ドフ 


rotates wap ハンド 






























拡張トランジシヨ 
ンをもっと利用した 
い人は、 kr 2 doc フォ 
ルダ内の吉里吉里2 
のドキユメントの中 
にある『トランジシ 
ヨ ンについて』をご 
覧ください。 

各ハンドラの属性 
について細かい情報 



トランジシヨン 

拡張トランジション機能はプラグインで提供ざれていますから、 KAG シナ 
リオの先頭にプラグインをロードする 1 行を書く必要があります。 

•タグ記述例 

[loadp 丄 ugin module="extrans.dll"] ¥ 

•シナ II 才例 

["[er]¥ 

画像を base の fore に表示〇 [1] 

[image layer=base page=fore storage^"testOl.bmp H ]¥ 

画像を base の back に表示 。 [1] 

[image layer=base page=back storage="test02.bmp"]¥ 

まずは wave ハンドラによるトランジシヨン。 [1] 

[trans method=wave time=3000]¥ 

[wt ] ¥ 

[er]¥ • 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer 二 base page=fore storage^"testOl.bmp"]¥ 

[image layer=base page=back storage 二 " test02.bmp"]¥ 

次は mosaic ハンドラによるトランジシヨン。 [1] 

[trans method=mosaic time=3000]¥ 

[wt ] ¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer=base page=fore storage="testOl.bmp"]¥ 

[image layer 二 base page 二 back storage="test02.bmp"]¥ 

次は turn ハンドラによるトランジシヨン。 [1] 

[trans method=turn bgcolor=0x000000 time=3000] ¥ 

[wt] ¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer=base page=fore storage 二 ,, testOl .bmp" ]¥ 

[image 丄 ayer=base page=back storage 二 " test02.bmp"]¥ 

次は rotatezoom ハンドラによるトランジシヨン。 [1] 
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[trans method=rotatezoom factor=0 time=3 000] ¥ 

[wt]¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image layer=base page=fore storage="testOl.bmp"]¥ 
[image layer=base page=back storage="test02.bmp"]¥ 
次は rotatevanish ハンドラによるトランジシヨン。 [1] 

[trans method=rotatevanish time=3000] ¥ 

[wt ] ¥ 

[er]¥ 

次のトランジシヨン用に画像をリセット。 [1] 

[image 丄 ayer=base page=fore storage="testOl.bmp"]¥ 
[image layer=base page=back storage="test02.Dmp"]¥ 
次は rotateswap ハンドラによるトランジシヨン。 [1] 

[trans method=rotateswap time=3000]¥ 

[wt]¥ 

これで終わりです。 [1] 


• 、V : ' 









キャラクターの立ち絵や シル エッ トなどの画像を読 
み込む には前景レイヤ-を利用します。 C こでは前 
景レイヤーの使し、方と、立ち絵のアニメーシヨンに 
ついて解説します 








Step 


前翬レイヤーを使ったキャラクター表示 



瘳_拳##馨 


前景レイヤーは 
論理上無制限の数 
を扱うことができ 
ますが、実質的に 
は PC のメモリやリ 
ソースなどに依存 
するため、1000枚 
も2000枚も使うこ 
とはできません。 

ですが、小さな 
前景レイヤーなら 
30枚や50枚程度使 
用しても特に問題 
はないので、一度 
見た画像をサムネ 
イル表示する CG ア 
ルバムなどに利用 
することができま 
す。 


前景画像を表示する 


KAG では1枚の背景画像の他に、任意の数の前景を表示させるための「前 
景レイヤー」と呼ばれるレイヤーがあります。これらの前景レイヤーには、主 
としてキャラクター.シルエットや立ち絵などの、背景の上に乗せて利用する 
絵を読み込んで利用します。 

前景レイヤーと背景レイヤーの違 I ゝは以下の通りです。 


比較項目 

前景レイヤー (0,1,2) 

背景レイヤー （ base ) 

mk 

〇〜3枚（論理上は〇〇) 

1枚 

初期状態 

非表示 

表 7 F 

画像の移動 

_5_ 

不可 


前景レイヤーに画像を表示する方法は背景レイヤーの時とほぼ同じですが、 
前景レイヤーを指定した時のみ利用できる属性が2つ追加されます。 


•タグ記述例 

[image storage = "charatestOl.bmp"layer=0 page 二 fore 
left=200 top=0]¥ 


top 属性は前景レイヤーに読み込む画像ファイルの上端位置を、 left 属性は 
左端位置を指定するために使います。この属性を省略すると、画面の左上を 
基点として前景画像が表示されます。 

また、前景レイヤーは最初は非表示になっているので、前景レイヤーを利用 
する前に必ず [ layopt ] タグを用いて前景レイヤーを利用可能にします。 


•タグ記述例 

Llayopt layer=0 page=fore visiDle=true]¥ 
[layopt layer=0 page=back visible=true]¥ 


上の記述例では、前景レイヤー0のフォアグラウンドとバックグラウンドの両 
方を可視状態にしていますが、必要に応じて片方だけ利用してもかまいません。 
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前景画像を表示する 


•シナリオ例__ 

[er]¥ 

背景を表示します。 [1] 

[image storage="testOl.bmp" layer=base page=fore]¥ 

前景レイヤー 0 のフォアグラウンドを可視状態にします。 [1] 

[lay opt layer=0 page=fore visiJDle=true] ¥ 

左上に黒い四角が見えるのは、前景レイヤーを可視状態にした時に何も画像 
が表示されていないことを警告するためのものです。 [1] 

画像を読み込めば消えるので、前景のキャラ絵を前景レイヤー 0 のフォアグ 
ラウンドに表示してみましよう。 [1] 

[image storage = "akira.png" layer=0 page=rore top=0 
left=200]¥ 

[er]¥ 

表示されました。 [1] 

続いてトランジシヨンで表示してみます。 [1] 

前景レイヤーを開放します。 [1] 

[freeimage layer=0]¥ 

[er]¥ 

[image storage="test02.bmp" layer=base page=forej¥ 
[backlay]¥ 

背景を base レイヤーのフォアグラウンドに表示し、ついでにバックグラウ 
ンドにもコピーしておきました。 [1] 

続いて、前景レイヤー 0 のバックグラウンドを可視状態にします。 [1] 

[layopt layer=0 page=back visiDle=true]¥ 

前景のキャラ絵を前景レイヤー 0 のバックグラウンドに表示します。 [1] 

[image storage = "akira.png"layer=0 page 二 back top=0 
left:200]¥ 

見えませんよね。 [1] 

それでは、トランジシヨン。 [1] 

[trans method=crossfade time=3000]¥ 

[wt]¥ 

トランジシヨンで前景が表示されました。 [1] 


■ 
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前景に利用する 
画像ファイルは、 
ファイル容量が大 
きくなってもよい 
のなら、展開速度 
の速い、 32 bitBMP 
を使い、配布形態 
の関係などから、 
容量を抑えたいの 
であれば a チヤン 
ネル付 PNG を使う 
とよいでしよう。 


前景レイヤーを使つたキャラクター表示 


あります。 

まずは、グラフィック•ソフトで絵を描く時に、背景の部分に何も色を乗せ 
ず、あくまでも透明の状態で書くことです。 

作成したファイルは《チャンネルと共に保存しますが、この状態ではまだ 
KAG では読み込めな t 、場合もあります。 


前景画像はキャラクターの立ち絵やシルエットですから、色が置かれている 
部分以外の部分は透明になっていないとゲーム内で使えません。 

このため、前景画像を作る場合にはいくつか注意しなければならないことが 


そこで利用するのが、 kirikiri 2 フォルダ内の 「 graphconv 」 の中にある、 
「 krkrtpc . exe 」 というプログラムです。 

これをダブル • クリックで起動し、前景画像として利用したいファイルをウ 
インドウの上にドロップすれば、 KAG で読むことのできるファイル形式に変換 
して出力してくれます。 


舞 • 、 霞 


Step 












前景画像のアニメーション 


■前景画像の アニメー シ 


前景レイヤーに表示させた画像は、もしそれがアニメーション形式のもので 
あれば自動的にアニメーションを行ないます。 

例をあげると、美少女系のアドベンチャーゲー厶にある目パチやロパクなど 
ですが、ファイルを準備しておけば KAG の方で勝手にアニメー ションを実行 
してくれるので、シナリオへの記述については通常の前景画像を読み込む書き 
方とまったく同じです。 

前景レイヤーに表示させるキャラクターをアニメーションさせる場合に必要 
なものは3つあり、ベースになる画像ファイル、アニメーションする部分のみ 
を集めたアニメーション用画像ファイル、そしてアニメーションの秒数やコマ 
を指定する ASD ファイルです。これら3つのファイルは、以下のように名前 
の付け方が決まっています。 


^TOkmmm 

名前の付け方 

サンブ/レ例 

ベースとなる画像ファイル 

任意のファイル名 . png 

akira.png 

アニメーシヨンファイル 

任意のファイル名 _ a.png 

akira _ a.png 


任意のファイル名 . asd 

akira.asd 


これらのファイルは3つまとめて同一のフオルダに置いておく必要がありま 
す。フォルダはどこでもかまいませんが、管理のしやすさを考えた場合、 「 fim - 
age 」 や 「 other 」 がよいでしょう。 

ASD ファイルの中は、以下のようになっています。 

*go 

@loadce 丄丄 

@loop 

/ 

©macro name=copyone 

@copy dx=62 dy=179 sx=%x sy=0 sw=90 sh=55 
@endmacro 
/ 

*start 

@copyone x=0 
@wait time=100 
@copyone x=90 


_ 拳# _ 















前景レイヤーを使ったキャラクター表示 


Step 


_ 

_ 


KAG シナリオ上 
では位置合わせが 
非常に難しいので、 
画像処理ソフト上 
でピクセル単位の 
位置決めをしてか 
ら KAG に持ってき 
たほうがいいでし 
よ9。 


@wait time=lOO 
@copyone x=180 
@wait time=7 0 
@copyone x=90 
@wait time=7 0 
@copyone x=0 
@wait time=3000 
/ 

@jump target=*start 


ASD の内容はサンプル例ですが、必要に応じて「=」の後ろにある数値を修 
正してください。それぞれの数値の意味は、以下のようになります。 


• r@copy dx =62 dy =179 sx=%x sy =0 sw =90 sh =55 J について 


dx=62 dy= 179 


これはアニメーション用の画像をベース画像 
の左上から何ピクセルの位置にアニメーション 
ファイルのパターンセルを表示するかを指定す 
る値です。 「 dx 」 が横ピクセル数で、 「 dy 」 は 
縦ピクセル数です。 

両方とも「0」にするとアニメーションパタ 
ーンがベース画像の左上に表示されます。ま 
た、数値をベース画像のサイズ以上に指定す 
るとベース画像の外に出てしまい、表示されな 
くなります。 



sx=%x sy=0 

これは アニメーション 用の画像から1枚ごとのセルを切り出す位置を指定す 
る値です。ここでは マクロを 使って表記されているのですが、意味は分からな 
くても数字だけ修正すればすぐに利用できます。 （マクロ — Step 7) 
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前景画像のアニメーション 


參#蠡# 

一 sw=90 sh 二 55_ _ ； _ 

これはアニメーション用の画像に含まれているセルの1つあたりのサイズを 
指定する値です。サンプルでは90ドット X 55ドットのセルが3枚並んで270 X 
55ドットのアニメー ション.ファイルになっていますが、指定するのは1枚の 
大きさですから「90」と「55」になります。 



•その他の部分について 

*start 

@ copyone x=0 
@wait time=100 
@copyone x=88 
@wait time=100 
@copyone x=176 
@wait time=7 0 
@copyone x=88 
@wait time=70 
@copyone x=0 


この中から 「 @copyone x= 」 の行だけを抜き出して、 x の値を先ほどの 
(sx, sy) の部分に代入してみると、 
sx=0 sy=0 
sx=90 sy=0 
sx=180 sy=0 
sx=90 sy=0 
sx=0 sy=0 










前景レイヤーを使ったキャラクター表示 

# 
m I 


鬱鬱 # 參 ## 


となります。 G れは何をしているかというと、アニメーション•ファイルの1 
枚ごとのセルがどの位置から始まるのかを指定しているのです。 

1枚 目のセルには、アニメーション.ファイルの左上を原点として（0,0)の 
位置から 「 sw =90 sh =55」 で指定されたぶんの画像が当てられます。 2枚 目の 
セルには、アニメーション.ファイルの左上を原点として (90,0) の位置から 
「 sw =90 sh =55」 で指定されたぶんの画像が当てられます。 3枚 目のセルには、 
アニメーション. ファイルの左上を原点として（180,0)の位置から 「 sw =90 
sh =55 j で指定された分の画像が当てられます。 4枚 目のセルには、2枚目の 
セルで選択した画像がそのまま当てられます。 5枚 目のセルには、1枚目のセ 
ルで選択した画像がそのまま当てられます。 



こまでで、目を開いている状態から一度閉じ、さらにまた開くまでのサイ 


クルが アニメ ーションとして記述できたことになります。 

ここまでの例のように、横にアニメーションのセルパターン 
を配置する場合は、 「 sy 」 の値は常に「0」になりますが、右の 
ような縦置きのアニメーションパターン.ファイルを利用する場 
合は、逆に 「 sx 」 が常に「0」で、 「 sy 」 をマクロで変化させて 
いく必要があります。 



• ASD ファイル例 

*go 

@loadcell 

©loop 
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©macro name=copyone 







■■ 


前景画像のアニメーション 


KAG 


@copy dx=62 dy=l79 sx=0 sy=%y sw=90 sh=55 

@endmacro 

7 

*start 

@copyone y=0 
@wait time=100 
@copyone y=55 
@wait time=100 
@copyone y=ilO 
@wait time=70 
@copyone y=55 
@wait time=70 
@copyone y=0 
@wait time=3000 
/ 

@jump target=*start 

最後に [ wait ] タグで指定された秒数ですが、これはアニメーションの次セル 
を表示するまでに待つ時間を指定します。抜き出して並べてみると、以下のよ 
うになります。 


@wait time=/0 
@wait time 二 /0 
@wait time=3000 

開いている状態から閉じる状態までは 0.1 秒刻み、閉じている状態から開い 
た状態までは0.07秒刻みにしてあります Q 

いちばん下にある [ wait ] タグは、瞬きをしてから次に瞬きをするまでの間隔 
を指定するもので、ここでは3秒にしてあります。 
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前祭レイヤ _ を使ったキャラクター表示 

■; ' ..バぐ..'.....—\ :: ■ ..... 

籲 


■前景画像の移動 [ move ] [ wm ] 


KAG でタグを記 
述する場合は、「_•」 
や「_」の数が偶数 
でないとエラーに 
なります。 

「•_」や「_」は何 
かをクオートする 
(括る）ために用い 
る記号なので、奇 
数の場合は終わり 
が閉じていないこ 
とになるからです。 

変数や条件分岐 
を扱う上で、思つ 
たように動かずエ 
ラーが 出るのは、 
このクオーテーシ 
ヨンマークが対に 
なっていない場合 
がほとんどです。 



前景レイヤーに表示させた画像は移動させることができます。このような場 
合は [ move ] タグを使います。通常は移動が完全に終了してから次の命令を行 
なわせることが多いため、必要ならば移動の終了を待つ [ wm ] タグも使います。 

•タグ記述例 

[move layer=0 time 二 3000 pa th =" (640,0,255)"]¥ 

[wm] ¥ 


「 layer 属性」では移動させる画像が表示されているレイヤー名を指定する 
ので、この場合は「前景レイヤー0」を指定します。 

「 time 属性」には移動を行なう時間を指定します。 

「 path 属性」には、移動先の（ X 座標、 Y 座標、レイヤーの濃度）をそれ 
ぞれ指定します。 

「 X 座標」の値は、画面全体の左上を「0」として、表示されている画像の 
左端が右側に何ピクセルの位置まで移動するかを指定します。後述のシナリオ 
例の場合は画面の右端を指定したので、画像は画面の外へ向かって出て行く 
ことになります。 

「 Y 座標」も同様ですが、こんどは縦位置です。画面全体の左上を「0」と 
して、表示されている画像の上端が下側に何ピクセルの位置まで移動するかを 
指定します。後述のシナリオ例の場合は「0」なので、垂直方向へは移動しな 
いことになります。 

「レイヤー濃度」は、前景レイヤーの透明度を操作する値です。「255」な 
ら何も変わりませんが、「0」にすると完全に透明になります。中間値を設定 
すると半透明になります。 
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前景画像の移動 [ move ] [ wm ] 


•シナリオ例 

[er]¥ 

背景を表示します。 [1] 

[image storage="test 01 .Dmp" layer 二 base page 二 forej¥ 

前景レイヤー 0 のフォアグラウンドを可視状態にしてから、前景のキャラ絵 
を前景レイヤー 0 のフォアグラウンドに表示してみます。 [1] 

L 丄 ayopt layer=0 page=fore visib 丄 e 二 true]¥ 

[image storage="akira.png"layer=0 page=fore top=0 
left=200]¥ 

表示されました。 [1] 

では、右のほうへ移動させてみましよう。 [1] 

[move layer=0 time=3000 path="(640,0,255)"]¥ 

[wm] ¥ 

移動しました。 [1] 

[er]¥ 

もう一度背景を表示します。 [1] 

Limage storage="test 02 .bmp" layer 二 base page=fore]¥ 

もう一度前景レイヤー 0 にキャラ絵を表示。 [1] 

[layopt layer=0 page 二 fore visible=true]¥ 

[image storage="akira.png"layer=0 page=fore top=0 
left=200]¥ 

表示されたので、今度は下のほうへ移動させてみます。 [1] 

しかも、最終的には透明になるようにしてみます。 [1] 

[move layer-=0 time=3000 path=" (200 ,480,0 ) " ] ¥ 

[wm] ¥ 

消えてしまいました。 [1] 


左のシナリオ例 
は、画面サイズを 
標準の 640 X 480 で 
動作させた場合の 
例です。 

画面の外にキヤ 
ラクターを移動さ 
せたい場合は、自 
分が扱っている画 
面サイズがいくつ 
なのかによって、 
指定する数値が異 
なってきます。 
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画像だけ▼なく文字表示においても細かし)調整が 
行なえる点は吉里吉里/ KAG の魅力です。ここ 
では文字表示に 関する テクニックを解説します。 


X ?表示のテクニック 












文字表示のテクニック 



color 属性に指定 
されている OxffOOOO 
は、色を RGB の16 
進数で表したもの 
で、この場合は赤 
色を指定していま 
す。 

これらの カラー 
コー ドは html のも 
のとまったく同じ 
ですから、手持ち 
の html エディタの 
カラー パ レツト か 
ら16進数表記を確 
認すれば、どの色 
にどの数字を使う 
のかが簡単に分か 
ります。 


size 属性に指定 
される数値はピク 
セル単位です。 
html のフオント指 
定パラメータとは 
異なるので注意し 
てください。 


ED 

KAG シナ 


フオント属性による文字装飾 [ font ][ resetfont ] 


VG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された色や大きさ 
で画面に表示されますが、これは [ font ] タグを使うことによってシナリオ中で 
任意に変更することができます。 


•タグ記述例_ 

[font color=0xff 0000 size=25 face= "Mo 明朝 "] 

[font color^default size 二 default face=default] 
[resetfont] 


シナリオ内に [ font ] タグが書かれると、それより後の部分がタグで指定され 
た文字属性に従うようになります。 

色や大きさを元に戻したい場合は、2行目の [font color == default ....] のような 
書き方をして各属性を 「 default 」 に戻すか、すべての属性を一気に rConfittjsJ 
で指定された値に戻す [ resetfont ] タグを使います。 

2行目のような書き方は、一部戻したくない属性がある場合などに利用し 
ますが、 [ font ][ resetfont ] をペアで利用したほうが、 html の「く font > 〜 </ font>J 
のような認識ができるため、理解しやすいと思います。 

•シナリオ例_ 

洞窟を進んでいくと、足に何か当たった。 [1] 

ゆっくりと懐中電灯の光を向けてみる。 [1] 

光の中に浮かび上がったのは、変色した [font color=0xff 0000 ] 頭蓋骨 
[resetfont] たっ / こ 0 [1] 

[font size=52] 「うわあ！」 [resetfont][1] 

ぼくは大声を上げると逃げ出した。 [1] 


制讲 A 求ん: V と、り 
ゆ，ベり.し懐屮屯灯の） t を A けてみろ.: 
光の中に浮かび I :がつたのは、変色 L . 

「うわあ！」 

ぼくは大声を h げると逃げ出した。 ▼ 
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実行画面 
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文字の表示速度 [ delay ] [ nowait ] [ endnowait ] 


MU 


彙馨# _ _ 籲 _ 


4-2 


文字の表示速度 [delay 】 [nowait] [endnowait] 


KAG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された速度で表示 
されますが、これは [ delay ] タグを使うことによってシナリオ中で任意に変更す 


ることができます。 


•タグ記述例 

Ldelay speed=500] 


「 speed 属性」には、文字を表示させる間をミリ秒単位で指定します。500 
の場合は、1文字表示するごとに 0.5 秒待つことになります。 

これも前述の [ font ] タグと同様に、タグが書かれた位置からタグで指定され 
た速度に従って表示されます。 

元に戻す場合は 「 speed = user 」 としますが、これはユーザーがプレイ時に吉 
里吉里のメニューで文字の表示速度を変更している場合があるからです。 

•タグ記述例 

[delay speed=user] 


意味としては 「 speed = default 」 なのですが、その規定値が user に委ねられ 
ているため、このような表記になります。 

また、ウェイトを「0」にして一気に表示させる場合は、 speed 属性に以下 
のように指定します。 

•シナリオ例 

まずは普通に。 [1] 

Ldelay speed=nowait] ¥ 

ここだけ一気に表示する。 [1] 

[delay speed= user] ¥ 

元に戻しました。 [1] 


れは、 [ nowait ] タグを用いて次のように書くこともできます。 


ラム^^ 


多くの場合、ユ 
ーザーは最高速で 
メッセージを表示 
させていることが 
多いようです。ち 
なみに私もそうな 
のですが、どうし 
て市販のゲームは 
あんなにメッセー 
ジ表示速度が遅い 
んでしよつね。ま 
さかクリア時間を 
意図的に引き延ば 
すため……？ 
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文字表示のテクニック 




私の場合は、速 
度を細かく調整す 
る場合は [ delay ] 夕 
グを、一気に表示さ 
せる場合は [ nowait ] 
タグを使っていま 
す。 




蠢 シナ U 才例 __ 

まずは普通に。 [1] 

[nowait] ¥ 

ここだけ一気に表示する。 [1] 

[endnowait] ¥ 

元に戻りました。 [1] 

ウェイトを掛けないのなら、こちらのタグのほうが扱いやすいと思います。 









作り手と遊び手 
の意識の差がいち 
ばん出るのが、こ 
のウェイト処理で 
すね。 

「遅いぞ一遅い 
ぞ一」と言いなが 
らボタンやキーを 
押しまくつた経験 
は誰にでもあると 
思いますが、この 
あたりはできるだ 
け ユーザー フレン 
ドリーな仕様にし 
てあげましょう。 


■文字の表示ウェイト [ wait ] 


文字を表示しているときに、次の文字を表示するまでに一定の時間待たせ 
たいことがありますが、このような場合は [ wait ] タグを用います。 

•タグ記逑例 

[wait time=500]¥ 

•シナリオ例_ 

「どういうことなのよ！」 [1] 

[wait time=1000] ¥ 

「じ . [wait time=1000] 実は . [wait time=1000 ] これには深いわ 

けが …… 」 [1] 

「もっとハキハキしやべりなさいよ！」 [1] 


実は、この [ wait ] タグはクリック連打による読み飛ばしができてしまいます。 
演出の都合上どうしても待たせたい場合には、属性 canskip を使って、以下の 
ように書きます。 

•タグ記逑例 

[wait time=500 canskip=ralse] ¥ 


このように書かれた [ wait ] タグは、ユーザーが何をどうしようと必ず指定の 
時間だけ待つようになります。あまり多用すると嫌がらせになるので、注意し 
てください。 
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4-3 文字の位置表示 [ locate ] [ style ] [ resetstyle ] 


4-3 


文字の位置表示 [locate] [style] [resetstyle] 



KAG シナリオに書かれた文字は、 「 Config . tjs 」 内で指定された「メッセージ 
レイヤー0」上に順番に表示されますが、 [ locate ] タグを用いることによって任 
意の場所に表示することができます。 


•タグ記述例 

[locate x=100 y=200] ¥ 


また、センタリングや左詰、右詰などをした t 、場合は [ style ] [ resetstyle ] タグ 
を使います。 

•タグ記述例 

[style a 丄 ign=centerj ¥ 

[resetsty 丄 e] ¥ 


align 属性は、「横書き」の場合は 「 left 」「 center 」「 right 」 のいずれかを指 
定します。「縦書き」の場合は、 「 top 」「 center 」「 bottom 」 のいずれかを指定 
します。 

位置を元の状態に戻す場合は、 align 属性に 「 default 」 を指定するか、 [ reset - 
font ] タグを使います。 


籲シナリオ例_ 

★start 

[locate y=300]¥ 
[nowait] ¥ 

[style align=center]¥ 
ゲームをはじめる 
セーブデータを口ー ドする 
ゲームを終了する 
[resetstyle] ¥ 
[endnowait] ¥ 




iPci 

> c ご .' 
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文字表示のテクニック 


■インライン画像の表示 [ graph ] 



KAG では、アスキーテキストとして表示可能な文字の他に、オリジナルの 
絵文字も他の文字と同様に扱うことができます。 

これらの絵文字については、前景レイヤーに表示するキャラクターの立ち絵 
と同様、透明処理された PNG ファイルが推奨されています。 

このようなオリジナルの絵文字を KAG では「インライン画像」と呼び、表 
示するためには [graph] タグを使います。 

•タグ記述例 

[graph storage:"heart.png" char=false]¥ 

上の記述例では、” heartpng" というファイルで提供される絵文字がインライン画 
像として1文字提供されます。シナリオに書き込む場合は以下のようになります。 

_シナ II 才例 

A 子.取 io ： [graph storage= "heart .png" char=false] し飞る？ [1] 
B~j-. してるよ一 [graph storage= "heart .png" char=false][1] 

属性 「char」 に 「true」 を指定した場合はインライン画像を文字として扱 
い、 「false」 を指定すると本来の画像として扱うようになります。 

「true」 にしておくとインライン画像自体を [font] タグでさまざまな色に変える 
ことができるので、こちらのほうが便利です。 

•シナリオ例 __ 

A 子：最近 [font color=0xrf00ff][graph storage 二 " heart.png' 
char=true] [resetfont] レぐる？ [1] 

B + : してるよ一 [font color=0xff0000] [graph storage= "heart .png" 
char 二 true][resetfont][1] 

A 子：うお、真っ赤だ。燃えてるね。 [1] 

日子：う一ん、そうでもない 0 実は [font color=0xff 900 0] [graph 
storage: "heart .png" char=true] [resetfont ] って感じ 0 [1] 

A 子：たそがれてるの？ [1] _ 

このように、1つの 「heartpng」 をさまざまな色で扱うことができます。 
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インライン画像の例 


KAG で扱う文字は、それがひらがなだろうがカタカナだろうが漢字だろう 
が、すべてに対してひらがなだろうがカタカナだろうが漢字だろうがあらゆる 
種類のルビが振れます。この場合、 [ ruby ] タグを使います。 

•タグ記述例 

[ruby text =" ふりがな "] 

[ ruby ] タグの直後にある文字一文字に対して、 text 属性で指定した文字がル 
ビとして割り当てられ、横書きの場合は文字の上に、縦書きの場合は右側に 
表示されます。 


だからといって、 
ひらがなに漢字の 
ルビなど振らない 
‘ように。 


[ ruby ] タグに関し 
ては次に漢字など 
の文字がくる都合 
上、タグ行末に半 
角の¥は絶対に書 
きません。 


•シナリオ例 

「 [ruby text= " う "] 盂 [ruby text= " ら ”] 蘭 [ruby text=" ぼん"]盆 
[ruby text= " え "] 会って何でしようね」 [1] 

ぼくが言うと、藤井さんは呆れたように言い返してきた。 [1] 

「この [ruby text パご"]期に及んでそんなことはどうだっていいだろう 
が 0 頭を [ruby text:" フォ "] 初 [ruby text:" — マ "] 期 [ruby text 二 " 

ット "] 化しろってんだ」 [1] 

ルビのサイズはシナリオ内で任意に変更することはできず、 「 Config . tjs 」 内 
の設定によって決定された値が最後まで弓 I き継がれます。 


ルビを美しく見せるためには、本文の文字サイズや行間サイズにも注意しな 
ければいけません。 

また、これは出版物でも词じことが言えるのですが、1文字や2文字の少 


文字の位置表示 [locate] [style] [resetstyle] 


1 l つの .....E と li? 」 

ぼくが訊ねると老人は: 


fv 

/ c 


:の五つじや」 
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文字表示のテクニック 

1 数の文字に長いルビを普通に振るとルビ同士が重なって読めませんし、ルビの 
サイズを小さくすると、字が見えなくなってしまいます。 

このような時は、最初の一文字に対して一気にすベてのルビを振るのです 
が、そのときにルビテキストの先頭に数文字の空白を入れてルビの位置を手動 
で調整します。 

春シナリオ例 

[[ruby text=" _ __ サンダーソード "] 雷霆剣が落ちている。 [ 1 ] 



こうすると、美しいルビを振ることができます。 


インデント機能 [ indent ] [ endindent ] 


ドラマの脚本のようなレイアウトをしたい場合には、 [ indent ] [ endindent ] 夕 
グで提供されているインデント機能を使います。 

•シナリオ例 

[font face=" MS 明朝 ”] ¥ 

お釈迦様 「 [indent] これは目連ではないか。一体どうしたのじゃ？ 何か 
困ったことでもあるのか ？」 [endindent ][ 1 ] 

目連 「 [indent] はい、実を申しますと、亡者となった母が餓鬼道に落 
ちて苦しんでいるのでございます。何とか救おうと努力したのですが、供え 
た食物は全て炎の玉となって燃え上がり、母は何も食べることができずにお 
ります」 [endindent][1] 

お釈迦様 「 [indent] そうか …… 。では、その理由がお前にわかるか？」 
[endindent][1] 










4-3 文字の位置表示 [locate] [style] [resetstyle] 


吉罜吉罜 


シス f ム^)文字衷示 <© _菜統茂 ( J > 菜秘掷触ヘルプ妙 f ^< 8 > 


お釈迦様「これは@連ではないか。 - 体どうした 
のじや？ 何か困ったことでもあるの 
か？」 

P m 「はい、実を申しますと、亡者となった 
母が餓鬼道に落ちて苦しんでいるので 
ございます。何とか救おうと努力した 
のですが、供えた食物は全て炎の玉と 
なって燃え .1: がり、母は何も食べるこ 
とができずにおります』 

お釈迦様「そうか……〇では、その理由がお前に 
わかるか？」 ▼ 


先頭に [font] タグを置いた例 


: 吉1吉里 


システム⑤桨较どる u ) 酾 soi > ヘル:?妙 fry>m 


お釈迦様「これは f :: i 連ではないか。-づ本どうしたのじゃ 
, ?何か固ったことでもあるのか？」 

_連 r はい、実を申しますと、亡者となった母が餓 

鬼道に落ちて苦しんでいるのでございます。 
何とか救おうと努力したのですが、供えた食 
物は全て炎の玉となって燃え h がり、母は何 
も食べることができずにおります」 

お釈迦様「そうか……。では、その理由がお前にわか 
るか？」： ▼ 


[font] タグの行を外した例 

デフォル トの フォントは 「 ConfiUjs 」 内で プロポーショナル.フォン トが指 
定されているので、自動的に字詰めが調整されますが、使いにくい場合はシナ 
リオ例のように等幅 フォン トを指定するとよいでしょう。 


jPei 
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文字表示のテクニック 




# 


KAG の文字配匾座標について 

KAG における文字の配置は、以下のような値で定義されています。 


システム⑤文字表示©' mumw 醒秘 



• Config.tjs 例 


// ♦ 左右上下マージン 
；marginl = 8 ; / / と朱白 
； margint =28 ; / / 上余白 
； marginr =8 ; //右余白 
； marginb =8 ; / / F 余 口 
// ♦ 初期位置 
； left =16； //左端位置 
; top =16; //上端位置 
; width =608; // 幅 
； height =448 ; / / 晶さ 
// ♦ 右文字マージン 
； margmRCh =2 ; 


margmt=28 


需蘭益贫.序竟 
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4-4 KAG の文字配置座標について 
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_拳## 

初期位置はメツセージ • レイヤーの黒い四角の位置とサイズを決めており、 

左右上マージンは、その黒 t ゝ四角の上に実際に文字が表示される場合の位置 
を決めています。 

禁則処理に使う右文字マージンは、縦書きでは下文字マージンになり、句 
点や句読点、カツコの終わり、疑問符や感嘆符などが行頭に表示されないよ 
うにするための スペースと して使われます。 

これらのすべては [ position ] タグで変更することができます。 

•タグ記述例 

[position layer=messageO page=fore margin 丄 =8 margmt=28 
marginr=8 marginb=8 left=16 top=16 width=608 height=448]¥ 


「 Congif . tjs 」 で指定された内容と上記のタグは、同一内容になります。 

[ position ] タグで変更されたメッセージ.レイヤーの属性をリセットするタグ 
は存在しな t ゝので、上記のようにデフォルトの値を記述した行を1つ準備して 
おくと、変更を戻すときに便利です。 

文字のサイズや行間については、 rConfig . tjsJ の以下の部分で指定されます。 

書 Config.tjs 例 

// ♦ 文字の大きさ 
； defaultFontSize =18; 

// ♦ 行間 

; defaultLineSpacing = 2; 


rConfig . tjsJ の行間で設定された幅と、文字の大き 
さで指定されたフォント•サイズを元に予約された幅 
が、交互に並びます。文字表示が横書きに設定されて 
いる場合は、「幅」ではなく「高さ」になります。 



參_眷 
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分岐処理のあるノベル系ゲームなどを作るには選 
択肢の知識は必須です。ここでは選択肢文字表示 

に関するテク ニツクを解説します。 









また、 [ link ][ endlink ] で選択肢を配置した場合は、必ずその最後に [ s ] タグを置く 
必要があります。 [ s ] タグはシナリオの実行を強制的に停止するためのもので、プレイ 
ヤーが [ link ][ endlink ] で配置された選択肢を選ぶのを永遠に待ち続けます。これを 
置かないと、 [ link ][ endlink ] の次に書いたシナリオがどんどん実行されてしまい、最 
悪の場合は画面がクリアされて選択肢が消えてしまう事態が発生してしまいます。 

參シナリオ例 

洞窟は右と左に分かれていた。 [1] 

どっちへ行こうか。 [1] 

[link target = *scene01] 右手へ進む [endlink] 

[link target=*scene02] 左手へ進む [endlink] 


84 


選択肢とラベル 

. :: ' - .，一.... 


html を取り扱え 
る人は KAG のタグ 
をそれほど苦もな 
く理解できると思 
いますが、逆もま 
た然り。 

KAG のタグ打ち 
に憤れた方は、自 
分の ホームページ 
を html タグを打ち 
ながら作ってみる 
のもよろしいかと。 


選択肢とラペル 


r r r 
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市販の アドベンチャーゲームを 起動すると、『ゲームを始める』 『セーブデータを 
ロードする』『ゲームを終了する』などの選択肢が並んだメニュー画面が表示され 
ますが、これらのメニュー画面は KAG の選択肢機能を利用して作ることができます。 

必要なタグは [ link ][ endlink ] の二つで、このタグで挟まれた部分がマウスやキーボ 
ードで選択可能になり、指定されたジャンプ先にジャンプできるようになります。考 
え方は、 html の「く AHREF =***. html > ここをクリックしてね </ A >」 と同じです。 


•タグ記述例 


[ link ] タグの行は 
普通のコマンド行 
ではなく選択肢が 
表示されるため、 
行末に半角の¥を 
記述すると改行さ 
れなくなり、すべ 
ての選択肢が横一 
列に並んでしまい 
ます 

選択肢行¥の取 
り扱いについては 
注意してください。 


target 属性には選択されたときにジャンプする先を「*名前」の形式で指定しま 
す。これを「ラベル」と呼びます。ラベルは半角の「*」（アスタリスク）印で始 
まる任意の文字列であることが条件となっており、これが存在しないと、リンクを 
クリックしたときにエラーになるので注意してください。 [ link ] [ endlink ] タグと半 
角の「*」印で始まるラベルは切っても切れない関係にあります。一緒に理解す 
るとよいでしよう（ラベルについては次項で詳しく説明します)。 


[link target = *scene001] 右手へ進む [endlink] 
[link target=*scene002 ] 左手へ進む [endlink] 
[s] 









*scene01 

[er]¥ 

ぼくは右手へ進んだ。 [1] 

洞窟は行き止まりだった。 [1] 
ぼくはそこに座り込んだ。 [1] 

[s] 

/ 

*scene02 

[er]¥ 

ぼくは左手へ進んだ。 [1] 

外への出口が見えてきた。 [1] 
ぼくは思わず駆け出していた。 [1] 


上の例における半角の「；」 （セミコロン) で始まる行ですが、これはシナリオ 
を見やすくするための「セパレータ」です。シナリオは上の例のようにラベルごと 
に分けたほうが見やすいので、それぞれの [ s ] タグの直後に置きます。 [ s ] タグはそ 
こでシナリオの実行を永遠にストップしてしまうので、 [ s ] タグをまたいだ上下の 
つながりはないためです。 

セバレータについては、どんなものでも構いません。半角の「；」（セミコロン） 
が行頭にある場合、 KAG はその行を「注釈文」として解釈し、実行しないからです。 

•セ パレー タ例 __ 

；〇 • 〇 • 〇籲〇 • 〇 • 〇 _ 〇 _ 〇 • 〇 • 〇 • 〇 • 〇 # 

;]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]] 

井############ 井## 井##### 

上の セ パレータのように、 セミコロンの 後ろは何でもかまわないので、自分がい 
ちばん見やすいものを セ パレータとして決めておくとよいでしよう。 
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選択肢とラベル 


また、それぞれのラベルの直後に置かれている [ er 】¥ ですが、これがないと、ぺ 
ージが切り替わったように見えず、選択肢の直後にジャンプ先のラベルの内容が表 
示されてしまいます。 


吉罜吉罜 


システム迄）文字表示ぬ）粲統どる u ) mmmm 画面^)ヘルブ⑩テ•パック•必 


洞窟は右と左に分かれていた。 

どっちへ行 こ 

:うか。 

右手へ進む 


左手へ進む 


ぼくは右手/' 

、進んだ。. 

洞窟は行き1 

I :まりだった。 

ばくはそこに 

m り込んだ,: } 


画面表爪例 


このような状態に陥ることを避けるため、ラベルの直後には必ず [ er ] や [ cm ] [ ct ] 
などの文字消去タグを置 V ゝてください。 


選択肢を3つ以上使いたい場合も同様で、 [ link ][ endlink ] で囲まれた選択肢と、 
ジャンプ先のラベルを増やすだけです。 
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•シナリオ例 

*bunki 

[er]¥ 

洞窟は右と左に分かれていた。 [1] 

「どっちへ行こうか」 [1] 

[link target=*scene001] 右午へ進む [endlink] 

[link target=*scene002] 左キへ進む [endlink] 

[link target=*scene003] その場に座り込む [endlink] 
[link target=*scene004] 声を上けて泣く [endlink] 
[link target=*scene005] 今来た道を民る [endlink] 


*scene001 


[er]¥ 

ぼくは右手へ進んだ。 [1] 
洞窟は行き止まりだった。 [1] 
ぼくはそこに座り込んだ。 [1] 


*scene002 

[er]¥ 

ぼくは左手へ進んだ。 [1] 

外への出口が見えてきた。 [1] 
ぼくは思わず駆け出していた。 [1] 


*scene003 

[er]¥ 

ぼくはその場に座り込んだ。 [1] 
もうどうなってもいいや。 [1] 


選択肢とラベル 


*scene004 












I 画 ____ 

纖__|薄き舞 






選択肢とラベル 

_____議纖藝が ::::: 

B 

[ er ]¥ 

ぼくは声を上げて泣いた。 [1] 

涙はしょっぱかった。 [1] 


[ jump 】 タグにつ 
いてですが 、 BASIC 
をご存知の方は 
goto コマンドを思 
い出してください。 
あれとまったく一 


* scene 00 b 

[ er ]¥ 

ぼくは今来た道を戻ることにした。 [1] 

しかし、背後からはあの怨霊が追いかけてくるはずだ。 [1] 
やっぱり戻れない！ [1] 

[Dump target 二*] Dunki ] ¥ 


上の例では、「選択肢5」を選んだ場合のみ、もう一度選択肢を選び直させるた 
めに [ jump ] というタグを使っています。この [ jump ] タグは、 [ link ][ endlink ] とは違 
って、•プレイヤーが選択しなくても自動的に処理を指定のラベルに移す働きをもっ 
ています。 

•タグ記述例 

[jump target =* どこかのラベル]¥ 


[ jump ] タグは強制的に処理をジャンプさせるので、その下に書かれているシナリ 
才は [ jump ] より上に書かれたシナリオとは無関係になります。このため、慣れない 
うちは [ jump 】 の直後に [ s ] を書いておくと「ああ、ここで処理の流れが止まってい 
るんだな」と理解しやすくなります。 
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5-2 ラベルと セーブ • ポイント| 
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ラ AU レと セーブ • ボイン 



吉里吉里/ KAG で制作したゲームにはメニューに「菜をたどる」「菜をはさむ」 
という2つのコマンドがありますが、これは一般に言われる「ロード」「セーブ」 
のことです。 

KAG で作られた作品でプレイ状況をセーブする場合、ユーザーは自由な場所で 
セーブすることはできません。セーブ可能な場所は KAG シナリオ上においてラべ 
ルが書かれている行のみです。 

さらに注意なのは、ラベル行にセーブ•タイトルが記述されていないとセーブで 
きないことです。 


•セーブできないラベルの例 



•セーブできるラベルの例 

★start | スタート 
* opening |才ーフ—ンク 
★sceneOl | 出会し、 

ラベルの後ろに半角の縦棒 （ | ) を置き、その後ろにセーブ•タイトルを書い 
ておけば、プレイヤーはそのラベルでセーブできるようになります。 


セーブした場合、セーブ•タイトルは莱に表示されます。上の例では、ラベル 
「★ opening 」 でセーブしたら菜には『オープニング』と表示され、ラベル 「* scene 01」 
でセーブしたら菜には『出会い』と表示されます。 

選択肢を置く場合は必ずラベルを書かねばなりませんが、この場合、セーブ* 
タイトルは必須ではありません。そこでセーブさせたくないと思った場合は、セー 
ブ•タイトルを省略して純粋なラベルだけ書いておけばよいのです。 

この場合、プレイヤーが「菜を挟む」を使った場合、そこから一番近い過去に 
存在するセーブ•タイトルつきのラベルを通過した時の状態が、セーブデータとし 
て菜に保存されます。 

次の例を見てみましょう。 
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[title name="1999ChristmasEve"]¥ 

★start | オープ ニン グ 
[er]¥ 

ぼくは立花明。どこにでもいる普通の社会人。 [1] 

今日は 12 月 24 日。世間一般で言う、クリスマスイブ。 [1] 

イブの夜と聞いて、まず思いつくのは…… [1] 

ベイエリアの高層シティホテル。よく冷えたシャンパン。窓辺に飾った薔 
薇の花束。そして小さな箱に入ったクリスマスプレゼント。 [1] 

もしくは、小さなペンションホテル。お揃いのロシニョールのスキー板。 
暗い窓の外に舞う粉雪。そしてテーブルの上のキャンドルライト。 [1] 

え？その後……？ [1] 

その後って……雑誌にはそれしか書いてなかったけど……？ [p] 

[er]¥ 

まあ、それはさておき、昨年のクリスマス。 [1] 

ぼくは、数年前からひそかに恋していた女性を豪華なディナーに誘うこと 
にしていた。 [1] 

女性の名は桐野由美香。 [1] 

勤め先は別だが、ぼくと同い年で、ちょっとしたきっかけで知り合ってか 
らはまるで兄弟のように仲のいい友達だ。 [1] 

友達という間柄に妙な恋愛感情が混入するとつきあい方がギクシャクして 
くる前例は数多いが、ぼく達の場合はそうではない。 [1] 

ぼく自身は確かに由美香のことは好きだ。でも、それを簡単に口にできる 
ような男でもないし、言ったからどうなるとも思っていないのだ。 [1] 
「愛してるよ」…… [1] なんて、逆立ちしても無理だ。 [ P ] 

[er]¥ 

そんなこんなで、店の予約をしておきながらもぼくはなかなか本人を誘う 
ことができなかった。 [1] 

そして結論から言えば、ぼくはディナーの予約を恋人のいる友達に売りつ 
けてしまった。 [1] 

ぼくがやっと勇気を奮い起こして告げた時は、容姿端麗、明眸皓歯、才色 
兼備の由美香にはすでに先約が入っていたのだ。 [1] 

由美香はこんなふうに言っていた。 [1] 

「んもう、言い出すのが遅いわよ明。今年は友達とスキーに行くの。でも、 
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5-2 ラベルとセー: 



もし明さえよければ、来年のイブは今から空けておくわ」 [1] 

何とも気の長い話に聞こえるが、由美香の言葉としては別におかしくない。 
単純なぼくは、早速、一年先の計画を立て始めた。 [ p ] 

[ er ]¥ 

そしていよいよ、今年のクリスマスシーズン〇 [1] 

旅行先については、昨年の冬に発売されたパソコンゲーム『かまいたちの 
聖夜』にあやかって長野県白馬村のペンションホテルに決めた。 [1] 

実はこの ゲームには いわくがある。 [1] 


この例では、途中に [ er *] が3つ書かれていることから、文章は全部で4ページに 
渡って表示されます。 

たとえば、これをプレイしていて、最後の行の『実はこのゲームにはいわくがあ 
る』という文章を読んだところで菜を挟み、その栗を呼び出した場合、どこから 
ゲームが再開されるかというと、1ページ目の冒頭『ぼくは立花明。どこにでもい 
る . 』から始まります。 

つまり、 KAG の菜はいちばん最近に通過したラベルの位置を覚えていて、その 
時点でのデータをセーブするのです。 

それぞれのページ頭でセーブしたい場合は、 [ er ]¥ の行の直前に以下のようなラ 
ベルを記述します。 

•タグ記述例 

* start | オープニング 
[ er ]¥ 

ぼくは立花明。どこにでもいる普通の社会人。 [1] 

* start 2 |オープニング 
[ er ]¥ 

まあ、それはさておき、昨年のクリスマス。 [1] 

* start 3| オープニング 
[ er ]¥ 

そして結論から言えば、ぼくはディナーの予約を恋人のいる友達に売りつ 
けてしまった。 [1] 













長編の場合は、 
特に必要でない場 
所（たとえば長い 
シーンの中ほど） 
にもラベルを害く 
とよいかもしれま 
せん。 

10ページも20ぺ 
ージもラベルのな 
いシナリオを害い 
てしまうと、セー 
ブ • ポイントがは 
るか過去というこ 
とになり、ブレイ 
ヤーはロードする 
たびに苦痛を感じ 
るはずです。 

選択肢が途中に 
ある場合は否応な 
くラベルが存在し 
ますが、そうでな 
い場合は3〜5ぺ 
ージごとに適宜セ 
ーブ•ポイントを 
作ってあげたほう 
がいいでしよう。 


選択肢とラベル 
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* start 4| オープニング 
[ er ]¥ 

そしていよいよ、今年のクリスマスシーズン。 [1] 


このようにすベてのページにラベルを記述していくのは作業的に厳いゝのですが、 
これ以外に、各ページでセーブさせる方法はありません。 

また、上記の例ではセーブ•タイトルがすべて『オープニング』になっています 
が、セーブ•タイトルはラベルと違って重複可能です。もし、同じセーブ•タイト 
ルを記述するのが面倒な場合は、下記のように書きます。 

•タグ記述例 

★start |オープニング 
* start 2 | 

* start 3 | 

* start 4| 


ラベルの 右側に「 | 」だけ書けば、その直前に通過したセーブ•タイトルが引 
き継がれます。直前が同様に「|」だけの場合は、さらに遡っていちばん近いセ 
ーブ•タイトルを保存します。 

また、ラベルの直後の行には [ erncm ][ ct ] などの文字消去タグを必ず置くように 
します。この理由は、 KAG が菜に保存されたセーブ•データをロードするときに、 
必ず画面クリアを行なって、そこに書かれている文字をすべて消去してしまうから 
です。 

KAG では、画像レイヤーの状態、ロードされているファイルの情報、サウン 
ド.バッファやサウンド.ファイルの情報などは菜に保存しますが、メッセージ. 
レイヤーのどの位置にどの文字が表示されていたかという情報までは保存しません。 

このため菜をロー ドしたときには常に画面がクリアされるわけですから、その挙 
動と、普通に読み進めているときの状態を等しくしておく必要があり、このために 
ラベルの直後ではメッセージ.レイヤーをリセットする [ er ][ ct ][ cm ] タグを書く必要 
があるのです。 
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.一の作成例 


-例ですが、メニューを作るには以下のように書きます。 


•シナリオ例 

★start 

[position layer=messageO page=back frame ="" opacity =^ 00 ]¥ 
[playbgm storage :" test . mid "]¥ 

[image storage =" test 01 . bmp " page=back layer = base ]¥ 
[current layer=messageO page 二 back ]¥ 

[locate y = 260 ]¥ 

[ nowait ]¥ 

[style align 二 center ]¥ 

[link target =* opening ] ゲー厶をはじめる [ endlink ] 

[link target =* dataload ] セーブ 7 —夕をロー ドする [ endlink ] 

[link target =* option ] オノンヨノ [ endlink ] 

[link target =* end ] ゲームを終了する [ endlink ] ¥ 

Lstyle align = default ]¥ 

[ endnowait ]¥ 

[trans method=crossfade time = 2000 ]¥ 

[wt ] ¥ 

[current layer=messageO page = fore ]¥ 

[ s ] 


*opening 
[cm] ¥ 

オープニング。 [1] 
[s] 


*dataload 
[cm] ¥ 

データロード。 [1] 

[s] 



option 








選択肢とラベル 


[ cm ] ¥ 

オプション。 [1] 
[ s ] 


*end 
[ cm ] ¥ 

エンド〇 [1] 

[ s ] 


[ position ] タグは、以前メッセージ.レイヤーの位置やサイズを変更するときに説 
明しましたが、ここでは画像枠や透明度などの属性を指定するために利用します。 


システム®文字表示◎菜統沒 < i ) 菜をはさむ越画面幼ヘルブ ㈣ デパック⑪ 






ケームをはじめる 
セーブデータをロードする 
オプション 
ゲームを終 r する 


'ル1 ，.ぢ 


画面例 


•タグ記述例 

[position layer=messageO page=rore frame =" waku.png 
opacity = 255 ]¥ 
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ラベルとセーブ•ポイント 


KAG 


frame 属性は、メッセージ•レイヤーに画像枠を使 L ゝたい場合にファイル名を指 
定する属性です。画像枠が不要な場合は 「 frame = n 叫のように記述します。下の 
画面例では、画面下部に「メッセージ.レイヤー0」がメッセージ枠と一緒に表示 
されています。 



メッセージ枠を使った画面例 


opacity 属性は、メッセージ.レイヤーの濃度を指定する属性で、「255」のとき 
は完全な可視状態で、「0」にすると完全に透明になります。シナリオの画面例で 
は 「 opacity =200」 ですが、上の画像枠を使った画面例では「100」にしてあります。 

シナリオ例の5、17行目にある [ current ] タグは初めてだと思いますが、これは、 
文字を表記するためのメッセージ•レイヤーや、その裏表を指定するためのタグです。 

•タグ記述例 _ 

[current 丄 ayer 二 messageO page=back] ¥ 

[current layer=messageO page=fore]¥ 

[current layer 二 messagel page=fore]¥ 
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ここでは、メッセージ.レイヤー0のバックグラウンドに文字を表示し、背景画 
像と一緒にトランジションで表へ表示するために利用しています。トランジション 
が終了したら、きちんとメッセージ.レイヤー0のフォアグラウンドに戻しておき 
ます。 

選択肢として存在する4つの [ link 】[ endlink ] 部分に全角のスペースが記述されて 
いますが、これはマウス.カーソルが乗ったりカーソル.キーで選択されたときに 
表示される矩形の大きさを揃えるためです。ただし、この方法は、デフォルト•フ 
ォントがプロポーショナル*ではなく等幅フォント * の場合のみ利用できます。 

また、 [ link ][ endlink ] の最後の行の行末に半角の「¥」が置かれているのは、も 
しこの「¥」がないと、改行扱いになってしまって、次のページに進むためのクリ 
ック待ち記号が表示されてしまうからです。これは文字列が画面の下端に到達し 
たことが原因ですが、メニューが改ページしてしまうのは避けなければならないの 
で、最後の行に改行を中止する「¥」を置くことで回避しています。 
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変数の利用 


— — 

ただ読ませるだけの霪子小説を作ることに飽きた 
5、パラメータによる分岐処理、乱数、フラグに 
よるイベント管理など、変数を利用してプレイヤ 
一があ〇と驁く作品を作ってみましよう。ここでは 
変数の基本的な取り扱いについて解説します。 










挪の利用 


lllilplllilBlillB 

変数は「何かを 
入れておく入れ物」 
のことです。 

中学の数学で学 
ぶ x や a などがこれ 
に当たります。 


' '>' “ V 、 - ふ 




'人： 



KAG で取り扱える変数の形式 


二於 〆 

» r ノ 
'一 r — ノ 


ゲームの主人公の名前などをプレイヤーに入力してもらうためには、変数を 
利用します。 

KAG では、「数値変数」「文字変数」「フラグ」に区別はなく、すべて同一 
のものとして扱うことができます。このために変数に数値を代入すれば「数値 
変数」として、文字を代入すれば「文字変数」として、「0」か「1」を代入す 
れば「フラグ」として利用することができます。 

《変数の名前のルール》 

変数を使いたい場合、まずは変数に名前をつけますが、このとき、以下の 
ような ルールを 守ります。 

• 半角英数と全角文字のみ利用可 
•記号は「_」（アンダーバー）のみ利用可 

• ゲーム変数の名前は「幻、システム変数の名前は 「 sf .」 で始める 
•変数名の先頭に数字を使ってはいけない 
• 予約語は使ってはいけない 

•予約語®例 


count assign save load finalize invalidate mstanceof 
continue function debugger property default extends 
rina 丄 ly isva 丄 id typeof delete return export import switch 
global setter getter break false super catch class while 
throw const enum this void true null with else case for 
new var try in if do 


これらの単語は TJS 内で予約されているため、変数として使うことができま 
せん。たとえば、 「 f . count 」 や 「 sf . assign 」 という変数名は使えないので、注 
意してください。 
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6-1 変数の利用 


KAG 


《ゲーム変数とシステム変数の違い》 

「ゲーム変数」はゲーム•シナリオ内での処理に利用し、「システム変数」 
はゲームのシナリオを離れたシナリオの外で利用します。 

ゲーム変数は個々のセーブ•データに記録されるため、「吉里吉里」を再起 
動した場合は読み込まれません。このため「見たエンディング/見ていないエ 
ンディング」などを表わす変数データは保持することができません。 

システム変数は「吉里吉里」を再起動したときに真っ先に読み込まれるフ 
ァイル内部に記録されているため、どのセーブ•データをロードしても、最初 
からプレイをやり直しても、最後に代入された値が常に保持されます。 

ゲーム内の処理をするときに「ゲーム変数」を用い、シナリオ外のシステム 
的な処理に「システム変数」を使うことを覚えておいてください。 

•変数例 

f . okane f .hitpomt f .magicpomt f .koukando f .pastime 
sf . endinqOl s f . name sf .pic ture show sf . wdee など 


■変数を使った名前入力 


ここでは、「あなたの名前を入力してください」と促すダイアログを開き、 
入力してもらった文字列を変数に格納して表示してみます。 

恋なたの苗芊は？ 


:：齡:リ” ：'二'二'… 

... . _ 

OK 14ヤンセル 

Ummmmmmmmrnmmmm _ 嶋赚卩 "_ 刪 ___ • 啣 ___ 


名前を入れておくための文字変数は 「 f . name 」 にしたいところですが、苗字 
と名前を別々の変数に格納したいので、 「 f . sname 」「 f . name 」 と2つ準備します。 

続いて、画面に入カウインドウを表示してプレイヤーに名前を入力させます 
が、ここで利用するのは [ input ] タグです。 

•タグ記述例 

[input name=f . sname prompt :" あなたの苗字は？" title = "苗字の入 
力"]¥ 

[input name=f .name prompt =" あなたの名前は？" title =" 名前の入 
力"]¥ 


____ 
.よ:免 

1 . 
__圓 

■■111 


変数に名前をつ 
ける場合は日本語 
をローマ字で表記 
した名前をつける 
と、予約語とぶつ 
からずに済みます。 

ローマ字ではか 
っこ悪いと思う方 
は、予約語リスト 
を覚えて意図的に 
回避してください。 


__ 


_議 


_ 


■ 


■ 
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上の例では、何も文字が入力されていない状態でエンター.キーや 0 K ボタ 
ンを押した場合、変数が空の状態でシナリオが進んでしまいます。このため、 
入カダイアログを表示する前に最初からサンプルの文字列を変数に代入してお 
けば、名前が空白のままでシナリオが始まるというトラブルが起きません。 

変数に数値や文字などの値を恣意的に代入するには [ eval ] タグを使います。 

•タグ記逋例 



これで rf . snamej には 「P I A 」 という文字列が、 「 f . name 」 には「少尉」 
という文字列が入りました。 




*inputname 
[ er ]¥ 

あなたの名前を教えてください。 [1] 

[input name = f . sname prompt : 1 ' あなたの苗字は？” title : "苗字の入力"]¥ 
[input name = f.name prompt : •'あなたの名前は？" title = "名前の入力’'] ¥ 
あなたの名前は [font color =0 xf f f f 00 ] [emb exp=f . sname ] [emb 
exp=f . name ] [resetfont ] でし、し、です力、？ 

[link target =* ok ] し、し、 [ endlink ] 

[link target =* mputname ] 7 こめ [ endlink ]¥ 
ts ] 


内すン l 字つ 
才定シテ文を 
リ音ず一て薜〇 
ナを必才 ') るれ 
シ列はク{く 5 JJ 
一 AG 字合 •ンくく 
2文場ルョをて 
でるグシ列け 
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6-1 変数の利用 


BBfci 


変数内容の評価による条件分岐 


長い名前や、使ってほしくない名前を使われた場合の他に、何も入力しな 
かったり、入力されていたサンプルを消してしまった場合、これらの変数内容 
を評価し、必要なら再入力させることができます。 

これらは条件分岐なので、 [if] タグを用います。 [if] タグは必ず [endif] とペア 
で使います。 

まずは変数 f.name に入力された名前が『少尉』のときは入力をやり直させ 
るシナリオ例です。 

•シナリオ例 

*inputname 
[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f.name prompts • あなたの名前は ？" title= " 名前の入力 "]¥ 
[if exp=" f • name==' 少尉 ’"]¥ 

[jump target 二 * inputname_02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp-I.name] [resetfont] 
でいいですか？ 

[link target 二 * ok] し、し、 [endlink] 

[link target=*inputname ] だめ [endlink]¥ 

[s] 


この場合、 「f.name」 という名前の変数に「少尉」という文字列が入力され 
ている場合は [if][endif] の間が実行されます。つまり [jump] タグによるラベル 
ジャンプが行なわれるわけです。 

次に、変数 rinamej の内容が空の場合に入力をやり直させるシナリオ例 
です。 


[ if ] による条件分 
岐において前後が 
等しい場合はイコ 
—ルは2つ必要で 
す。これを1つし 
か窨かないと意図 
した処理ができま 
せん。このときエ 
ラーは 返らないの 
で、注意してくだ 
さい0 

条件分岐の詳細 
について は「数値 
変数」の項で詳し 
く説明しています。 
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棚の利用 




•シナリオ母__ 

*inputname 

[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f.name prompt=" あなたの名前は ？" title=" 名刖の入力 "]¥ 
[if exp="f•name== 11 "]¥ 

[jump target 二 * inputname_02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f .name] [resetfont] 

でいいですか？ 

[link target=*ok] し、しヽ [endlink] 

[link target=*inputname_02] だめ [endlink]¥ 


シングル•クオーテーションを 2 つ並べて記述すると、「空」の意味になります。 
また、これらの2つの条件分岐を1つにまとめることもできます。 

鼸シナリオ例 

*inputname 
[er]¥ 

あなたの名前を教えてぐださい。 [1] 

[input name=f.name prompt= " あなたの名前は ？" title=" 名前の入力 "]¥ 
[if exp=" f • name== 1 少尉 ’ | | f •names: ' 1 " ] ¥ 

[jump target=*mputname_02]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f .name] [resetfont] 
でいいですか？ 

[link taxget=*ok] し、し、 [endlink] 

[link target=*inputname 一 02] だめ [endlink]¥ 




半角の「 I 」を 2 つ続けて記述すると、 rORj の意味になり、どちらかの条件を 

「 I I J で、 AND には 

を手![，します。 満たしていれば 「 xp 」 による評価式が“真”になりま尤3つ以上の条件を処理 

使い方は r 1 1」と同 

じです。 した v ゝ場合も、同様に評価式を延長して記述することによって処理できます。 


S 














•記迹例 

j [if exp=" f.name==' 少尉 1 | | f .name== 1 ' | | f .name ， Dee ' | | f .name 
• でぃ一 ， "] ¥ 


長すぎる名前を受け付けなくするには、文字変数に入力された文字列が何 
文字かを調べ、それを評価する式を作って入力制限を行ないます。 

変数に格納されて I ゝる文字の長さを調べるには、変数の直後に 「. length 」 
と書きます0 

•記述例 

I f.name.length 


•シナリオ例 

*inputname 
[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f.name prompt= " あなたの名前は ？" title= " 名前の入力 "]¥ 
Lif exp= ” f • name. length>3 | | f • name== ' ' " ] ¥ 

名前は 1 から 3 文字までです。 [1] 

再入力してください。 [1] 

[jump target=*inputname_0 3 ] ¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f .name] [resetfont] 
でいいですか？ 

[link target=*ok] し、し、 [endlink] 

[link target=*inputname_03] た,の [endlink]¥ 

[s] 
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菊败の利用 

_ 鐘::？4 


入力された文字が、ある特定のキーワードを含んでいるかどうかを調べる場 
合は、 r . indexOfJ を用います。 

「 indexOf 」 は、 「 A . indexOfCB 1 )」 の記述形式をとり、文字列 A の中で文字列 
B が現われる位置を調べます。文字列 A の先頭に文字列 B があれば返り値は 
「0」になり、文字列 A の2文字目に文字列 B があれば返り値は「1」になります。 

文字列 A の中に文字列 B が見付からない場合は返り値は「-1」になるので、 
これを評価することで、文字列 A の中に文字列 B が含まれているかを調べるこ 
とができます。 

•記迹例 

*mputname 

[er]¥ 

あなたの名前を教えてください。 [1] 

[input name=f.name prompt= " あなたの名前は ？" title= " 名前の入力 "]¥ 
[if exp=" f .name. indexOf (' ばか ， ）！ =-1 "]¥ 

悪口は言わないで、ちゃんとした名前を入力してください。 [1] 

[jump target=*inputname_04]¥ 

[endif]¥ 

あなたの名前は [font color=0xffff00] [emb exp=f .name] [resetfont] 
でいいですか？ 

[link target=*ok] し、し、 [endlink] 

[link target=*inputname_04] 7 こめ [endlink]¥ 

[s] 

上記の例では、 「 f . name 」 という変数に「ばか」という文字列があるかどうかを調 
ベています。もし 「 f . name 」 の中に「ばかじゃん」や「大ばか」、「かばかば」など、「ば 
か」という文字列が使われていた場合は 「 indexOf 」 への返り値は「-1」以外にな 
り、凹タグで定義された条件を満たすので、2行目のメッセージが表示されます。 
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■数値変数のフラグ利用 


続いて数値変数の利用ですが、数値変数は大きく分けて「数値変数」と 


「フラグ」の2種類の使い方ができます。 


まずは「フラグ」ですが、市販のゲームではプレイヤーが何かの アクション 
を行なった場合にスイッチを ON にし、後の条件分岐の時にスイッチの状態に 
よって分岐先を決定することが多々あります。このスイッチのことを「フラ 
グ」と呼びます。 


•シナ 1 J 才例 

*sceneOl| 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。どうしますか？ [1] 

[link target=*scene02] めぐんでやる [endlink] 

[link target=*scene03 ] めぐんでやらない [endlink] 


*scene02 | めぐむ 
[ct]¥ 

ぼくは旅人に食料を少し分けてやった。 [1] 

「あんたは優しい人だな。よし、一ついいことを教えてやろう」 [1] 

旅人はぼくが渡したパンを食べながら話し出した。 

「あの洞窟の床には、ーヶ所だけ石床が外れる場所がある。その下に宝が埋 
まっているって話だ。ま、俺は怪物に食い殺されるのは嫌だから行かないが、 
腕に自身があるなら行ってみたらどうだい？」 [1] 

[eval exp="f.hint=l"]¥ 

[jump target=*scene04]¥ 

[s] 


*scene03 丨めぐまない 
[ct]¥ 

ぼくは旅人を無視することにした。 [1] 


数値変数 


QQ3 
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__ 


瓣膽__:_麵 


# 



これから洞窟へ入らねばならないのだから P [ 1 ] 
[eval exp="f.hint=0"]¥ 

[jump target=*scene04]¥ 


*scene04 | 洞窟 
[ct]¥ 

ぼくは洞窟へ入っていった。 [1] 

[if exp="f.hint==l"][jump target=*scene04b][endif]¥ 
だが、洞窟には何もなかった。 [p] 


*scene04b 

しばらく歩いたところで、ぼくは先ほどの旅人の話を思い出し、床石を調 
ベてみることにした。 [1] 

なるほど、確かにーヶ所だけ外れそうな床石がある。 [1] 

__ [s] _ _ 

旅人に食料をめぐむと、 rihintj という変数の値が「1」になります。これ 
は、「旅人に洞窟の宝の話を聞いた」というフラグが ON になったことを意味 
します。これらを利用すれば、後に [ if ] タグで条件分岐を行なうときに、プレ 
イヤーのプレイ状態に従ってシナリオを分岐できるわけです。 

また、選択肢を選んだ時点でフラグの状態を変化させることもできます。こ 
の場合は、 [ link ] タグに exp 属性を記述します。 

•シナリオ例 

*sceneOl| 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。 [1] 

どうしますか？ [1] 

[link target=*scene02 exp= H f • hint=l ••] めぐんでやる [endlink] ¥ 

[link target= *scene0 3 exp= " f • hint = 0 "] めぐんでやらない 
[endlink]¥ 









6-2 数値変数 
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KAG の場合、変数を [ eval ] で指定しなければ、その変数は未定義の状態で 
扱われます。つまり、「0」の値を代入したい場合は、以下の記述例のように 
何も書かなくてもかまわないのです。 

•シナリオ例___ 

*scene01| 旅人 
[ct]¥ 

旅人が食料をめぐんでくれと言っています。 [1] 

どうしますか？ [1] 

[link target=*scene02 exp=" f .hint=l"] めぐんでやる [endlink] ¥ 
[link target=*scene03 "] めぐんでやらない [endlink] ¥ 


このように変数に値が入る方のみ記述しておけば、後に [ if ] タグで条件分岐させ 
た場合に、 「 f . button 」 が未定義の場合は「値=0」として利用できるわけです。 


■数値変数の演算と条件分岐 


KAG で一度定義した変数の内容は、シナリオ内で意図的に消去することが 
ない限り、シナリオ実行中はずっと保持されます。 

たとえば、主人公のライフ•ポイントのように、 ゲーム•スター ト時には 
「10」で、 罠にはまると減り、薬を飲むと回復するような値を管理するために 
使えます。 

•タグ記迹例 


鞠麵定 

[eval exp="f.lp=10"]¥ 

瑰在の傭に 3 を追加 

[eval exp="f.lp=f.lp+3"]¥ 

親在钃雜か 63 を滅 

[eval exp="f.lp=f.lp-3"]¥ 

現在の傭の 3 倍 

[eval exp="f.lp=f.lp*3"]¥ 

現在の儀の 3 分の 1 

[eval exp="f.lp=~~(f .lp/3) " ]¥ 


初期設定だけは 「 f . lp 」 に「10」という整数を代入していますが、それ以降 
はすべてイコールの右にも左にも 「 f . lp 」 が記述されていて、ちょっと変な式 
に見えますよね。これは、数学的に考えるとおかしいのですが「イコールの右 
側の値をイコールの左側の変数に代入する」という意味で、プログラムでは多 
く利用されている表記方法なのです。 
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ですから [eval exp =’’ f . lp = f . lp +3 ff ] という式は、「現在の “ tip ” (右側）に“3” 
をプラスして、それを新しい “ f . lp ” （左側）の値として保管しなさい」という 
意味になります。割り算の部分だけは「一」（チルダ）とカッコが書かれてい 
ますが、これは割り算の値が整数以外になってしまった場合に、商を切り捨て 
て整数化するためのものです。また、割り算で商ではなく余りを得たい場合 
は、半角スラッシュではなく、以下のように半角の「％」を使います。 

•タグ記迹例 

[eval exp="f • 余り =f • 割られる数 ％ f • 割る数 "]¥ _ I 


•シナ U 才例 

*start 

[er]¥ / 

[eval exp="f.apple=10"]¥ 

りんごが 10 個あります。 [1] 

何人で分けますか？ [1] 

[input name=f.nannin prompt=" 何人で分ける ？" title=" 人数の入力 "] ¥ 
[emb exp="f .nannin"] 人で分けました。 

[eval exp=" f .hiton=~~ (f .apple/f .nannin) " ]¥ 

一人あたり [emb exp= 11 f .hitori"] こです 0 

[eval exp="f.amari=f.apple%f.nannin"]¥ 

余りは [emb exp=" f . amari"] こです。 

[link target=*start] もラー度やる [endlink] 

[s] 


•変数の覚書 



りんごの総数 

tnwrtfn 

分ける人数 


一人あたりのりんごの数 


あまり 




6-2 数値変数 



変数を複数使った処理を行なうナ易合は、このように変数の覚書を作ってお 
くとよいでしょう。 

続いて、変数の内容による条件分岐ですが、以下の例のように記述するこ 
とによって [ if ] タグでその後の処理を分岐させることができます。 

まずは変数 rtokanej の値が500以下の場合のみお金を500もらえる条件分 
岐のシナリオ例です。 

•シナ 1 J 才例 

[if exp="f.okane<=500" ]¥ 

[eval exp="f.okane=f.okane+500"]¥ 

[endif]¥ 

続いて、変数 「 f . okane 」 の値が 500 以下の場合のみお金を 500 もらい、合計 
金額が10000を超えた場合は全部奪われてしまう条件分岐のシナリオ例です。 

•シナリオ例 

[if exp="f.okane<=500"]¥ 

[eval exp="f.okane=f.okane+^00"]¥ 

[if exp="f.okane>10000]¥ 

[eval exp="f.okane=0"]¥ 

[endif]¥ 

[endif]¥ 


最後に、変数 「 f . okane 」 の値が 500 以下の場合のみ、現在のお金を2倍に 
してもらい、さらに1000もちえるというシナリオ例です。 

•シナリオ例 

[if exp="f.okane<=500" ] ¥ 

[eval exp="f.okane=f.okane*2+1000"]¥ 

[endif]¥ 
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比較演算子の前 
後が等しい場合は 
イコールは2つ必要 
です。私の体験か 
ら言っても 、他の 
部分でイコールを1 
つしか窨かないの 
で、つい間違えて 
記述してしまいが 
ちです。 [ if 】 タグが 
動作していないと 
思った場合は、ま 
ずは等価の場合の 
イコールが2つ窨か 
れているかどうか 
を確認するとよい 
でしよう。 


[ if ] タグの復習になりますが、このタグの exp 属性で行なっていることは、 
「変数と文字」、または「変数と数値」、または「変数と変数」の照合です。も 
しこの照合結果が『一致』（つまり真）である場合は、 [ if ] タグと [ endif 】 タグ 
の間にあるタグが実行されたり、文章が表示されたりし、照合結果が『不一 
致』（つまり偽）の場合は、 [ if ] タグと [ endif ] タグの間の行は無視されます。 

[ if ] の記述をまとめると、下のようになります。 

[if exp= " 変数や定数等号不等号変数や定数 "]¥ 

( 条件に一致している場合の処理） 

[endif] ¥ _ _ _ 


上記の例は下のように1行でも書けます。 

[if exp= " 変数や定数等号不等号変数や定数"](条件に一致している 
場合の処理） [endif] ¥ 


変数や定数を書く場合ですが、数値や変数の場合はそのまま記述できます。 

•記述例 

[if exp="f.okane==1000"] 


文字列の場合は、ダブル•クオーテー ション （ n ) でく くります。 

•記述例 

[if exp=" f • hannin== 1 ャゴ 1 "] 


また、左右の定数や変数、文字列などを比較するための等号不等号につい 
ては、以下の種類があります。 


mmmm- 

前と後ろが等しい 


前が後ろ以上 

> 

前が後ろより大きい 

<= 

前が後ろ以下 

< 

前が後ろより小さい 

!sss 

前と後ろが異なる 
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6-3 乱数の利用 




「じゃんけんゲーム」や「ルーレット」などは、こちらが意図した結果をコンピュ 
ータが出してこない点が面白いのですが、これらを実現するためには、「乱数*」を 


使います。 


KAG では、乱数を発生させるジェネレータとして「 random 」 と「 intran - 
dom 」 というものが準備されており、 「 random 」 は0以上1未満の実数*を、 
「 intrandom 」 は指定値以上、指定値以下の整数*の乱数を生成します 。 KAG 
を利用してゲームを作る場合は、 「 intrandom 」 の方を利用します。 


•記述例 

[eval exp=" f . ransuu=mtrandom (1,100) " ] ¥ 


上の例では 「 f . ransuu 」 という変数に「1」から「100」のいずれかが代入されます。 


•シナリオ例 

*start 

[er]¥ 

さいころ勝負！ [1] 

[eval exp=" f . dice_player=mtrandom ( 丄 ， 6) " ] ¥ 

[eval exp=" f . dice_com=intrandom (1,6) " ] ¥ 

コンピューターの目 ： [emb exp= M f . dice_com"] 

プレイヤーの目 : [emb exp=" f . dice_player"] 

[if exp= " f . dice_com> f • dice_player "] コンピュータの勝ち！ 
[r][endif]¥ 

[if exp= " f • dice_com く f • dice_player "] プレイヤーの勝ち ！ 

[r] [endif]¥ 

[if exp=" f • dice_c 01 n==f . dice_player" ] bi き分け！ [r] [endif ] ¥ 
[link target=*start] もラー度やる [endlink] ¥ 

[s] 


さいころの目は1から6までなので 「 intrandom ( l ,6)」 という記述を行ない、 
それを [ eval ] タグを用いて 「 f . dice _ player 」 と 「 f . dice _ com 」 という変数にそれ 
ぞれ代入しています。あとはそれらを [ emb ] タグで表示し、 [ if ] で双方の値を比 
較してメ ッ セージを表示します。 




1 


幸乱数 

でたらめな数値 


議 _ 




醭叢を含む数。小数点の 
ついた数。 




olf 亂_数。 
小数点の無い数。 
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i : 蓮 


♦ザブルーチン 
祕 fouttne 

雄を行なラルーチン。 

' 

' 

' 

ベ 

.て' 

: ..て 

... ......... ' 

’’ 



ゲームを作っていると、定期的に変数の処理を行なわねばならないような場 
面に出くわす場合があります。 


例として、拙作 「1999 ChristmasEve 」 の第二話に厳冬の森の中を歩くシー 
ンがありますが、ここでは別のラベルに進むごとに時間が5分経過し、どこを 
どう歩いても120分を過ぎると自動的に凍死するシーンへジャンプする処理を 
しています。 

シーンは全部で50近くもあるので、各ラベルの冒頭に数値変数の処理をす 
るためのシナリオを書いていたのでは後で修正するときにも面倒ですし、何よ 
りシナリオが汚くなってしまうので、サブルーチンを使っています。 

「サブルーチン*」は、定型処理をするシナリオ部を一つだけ作っておき、 
必要に応じてそこにアクセスして処理を行なうことができるもので、これを呼 
び出すには [ call ] タグを、戻る場合は [ return ] タグを使います。 

•タグ記述例 

[call storage? フアイル名 .ks" target=* ラベル名 ]¥ 

Lreturn] ¥ 

[return storage: " ファイル名 • ks" target:* ラベル名 ]¥ 


•シナ U 才例 

*chapter2_scene04b | 第二話出発 
[eval exp=" f . spendtime=0'' j ¥ 
[eval exp="f.limittime=120"]¥ 
[er]¥ 

(前略) 

「さあ行こう！由美香！」 [1] 

「どつ ちへ . ？」 [p] 
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ぼくは、 

[delay speed 二 nowait][locate y=355]¥ 

[link target=*chapter2_scene06] A. 北の道を選んだ [endlink] 
[link target=*chapter2_scene09] B. 南の道を選んだ [endlink] 
[link target = *chapter2_scene05] C. 西側の雑木林に踏み入った 
[endlink] ¥ 

[delay speed=user]¥ 

[s] 


*chapter2_scene05 | 第二話西の雑木林 
[call target=*chapter2_timechecker] ¥ 

ぼく達は雑木林の中に踏み入った。 [1] 

外から見ただけではわからなかったが、 

立ち枯れた木が至るところに転がっており、 

とてもではないが歩けそうになかった。 [1] 

「無理だ、戻ろう」 [1] 

無言の由美香を連れて林を出たぼくは、 

もう一度慎重に行く先を検討することにした。 [1] 

ぼくは、 

[delay speed=nowait][locate y=3/5]¥ 

[link target=*chapter2_scene06] A. 北の道を選んだ [endlink] 
[link target=*chapter2_scene09] B. 南の道を選んだ [endlink]¥ 
[delay speed=user]¥ 

[s] 


*chapter2_scene06 丨第二話教会は西 
[call target=*chapter2_timechecker] ¥ 

五分ほど歩いたところで道が分かれていた。 [1] 

西に向かう道、北に向かう道、南に向かう道の三叉路だ。 [1] 
「教会は西よ …… 」 [1] 

背後の由美香がぼんやりと言う。 [1] 
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ぼくは、 

[delay speed=nowait][locate y=355]¥ 

[link target=*chapter2_scenel2] A. 西の道を選んだ [endlink] 
[link target=*chapter2_scene07] B. 北の道を選んだ [endlink] 
[link target=*chapter2_scenel4] C . 南の道を選んた [endlink]¥ 
[delay speed=user]¥ 


*chapter2_scene07 | 第二話違う気がする 
[call target 二 * chapter2_timechecker] ¥ 

五分ほど歩いたところで道が分かれていた。 [1] 

西に向かう道、北に向かう道、南に向かう道の三叉路だ。 [1] 

「違うような気がする……」 

背後の由美香が言う。 [1] 

ぼくは、 

[delay speed 二 nowait][locate y=355]¥ 

[link target=*chapter2_scenell]A. 西の道を選んだ [endlink] 
[link target=*chapter2_scene08] B. 北の道を選んだ [endlink] 
[link target=*chapter2_scene06] C _ 南の道を選んだ [endlink]¥ 
[delay speed=user]¥ 


*chapter2_timechecker 

[eval exp="f.spendtime=f.spendtime+5"]¥ 

[if exp=" f . spendtime>f .limit time] [return target 二 * 凍死シー 
ン ] [endif]¥ 

[er]¥ 

[emb exp=" f . spendt ime"] 分経過 / [ emb exp=" f .1 imitt ime"] 分 
[ 1 ] 

[return] 
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数値変数処理部のサブルーチン化 

參拳_ _ 



•変数覚書 



経過時間 

初期値は0 

は 獅 e 

限界時間 

初期値は120 


シナリオ例の最初と最後を除く各シーンの冒頭にある [call target =* chap - 
ter 2_ timechecker ] で、それぞれの場所から 「* chapter 2_ timechecker 」 という 
サブルーチンを呼び出して処理をし、終わったら元の場所に戻っています。 

サブルーチン部である 「* chapter 2_ timechecker 」 については、通常のラべ 
ル付きシナリオと同じ扱いで、特に「ここがサブルーチンだよ！」と宣言する 
必要はありませんが、利用する上でいくつかの注意点があります。 

① まず、サブルーチン部は [ call ] タグでのみアクセスできる場所に書くべき 
です。 KAG のシナリオは上から下に向かって順番にタグを実行するので、気 
がつ I ゝたらサブルーチン部も実行されてしまう場合があります。 

このような状態を避けるには、サブルーチンの前で [ s ] と [ jump ] を使い、サ 
ブルーチン部をジャンプして避けるか、サブルーチンは別のファイルにして 
[call storage 』 ファイル名. ks n target =* ラベル]で呼び出すようにします。 

② もうひとつは、サブルーチンのラベルにセーブ•タイトルを記述してはい 
けません。サブルーチンは本来見えない処理をする部分のはずですから、そこ 
でセーブされてしまった場合、ロードをした時に予期せぬ状態からゲームが始 
まることになるからです。 

さらに、サブルーチンとして記述したラベルの行末には必ず [ return ] タグが 
ないといけません。このタグはサブルーチン.ラベルをコールした部分の直後 
に戻るという大切な働きをしているからです。 

シナリオ例ではよく見ると 「 return 」 が二つありますが、中ほどの [ return ] 
は、経過時間が限界時間を超えた場合に凍死シーンへジャンプするためのも 
の、下の方の [ return ] はサブルーチン処理を終えてもとの場所に戻るためのも 
のです。 

中ほどの [ return ] については代わりに [ jump ] タグを使いたくなりますが、サ 
ブルー チン内部でのジャンプはすべて [ return ] タグで行わないと、 コール スタ 
ックと呼ばれる値が不正になり、結果として KAG が正常動作しなくなる場合 
があります。 


1 999 Christmas - 
Eve の例では、サブ 
ルーチン内に [ er ] 夕 
グを害いておいた 
ため、それぞれの 
ラベルの次行にい 
ちいち [ er ]¥ を置く 
必要がなくなりまし 
た0 

このように、ま 
とめられるものは 
極力まとめていく 
ことが、きれいな 
シナリオを害く秘 

訣になります。 

V _ ✓ 
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変数のイベント的な利用例 


変数や乱数を上手に利用すると、面白いイベントが作れます。 


ここでは、3つの扉があり、どれか1つにはお化けがひそんでいるイベント 
を作ってみます。お化けの隠れている扉は、乱数を利用してシナリオを実行す 
るたびにランダムに変わるようにします。 


①使5変数 



内容 

, VHHI i 

f.doorl 

扉 1 を開けたかどうか 

0 

f . door 2 

扉2を開けたかどうか 

0 

f . door 3 

扉3を開けたかどうか 

0 

f.fear 

お^:けがひそむ扉 （1 〜3でランダム） 



•記删 

[eval exp="f.door 1=0 "]¥ 

[eval exp="f.door2=0"]¥ 

[eval exp="f.door3=0"]¥ 

[eval exp="f.fear=intrandom(1,3)"]¥ 


② 変数の変 ft 

扉を一度開けたら変数の値を「1」にして、次からは選べないようにする。 

[eval exp="f.doorl=l"]¥ 

[eval exp="f.door2=1"]¥ 

[eval exp="f.door3=1"]¥ 


③ 変数の値による分岐処理 

変数 「 f . door *」 の値が「1」の時はすでに一度開けているため、次からは選 
択肢を表示しないようにする。ここでは 「 f . door *」 の値が「0」の時のみ選択 
肢を表示するように指定。 

[if exp=" f . doorl==0 "][link target=*doorl] 右の扉 [endlink] 

[r][endif]¥ 

[if exp=" f . door2 = = 0 M ][link target=*door2 ] 真中の扉 [endlink] 
[r][endif]¥ 
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[if exp="f .door3==0"] [link target=*door3] 左の扉 [endlink] 
[r][endif]¥ 

④お化け登場 

乱数で得られた番号の扉を開けた時、恐怖が飛び出す。 

*doorl 

[er]¥ 

[if exp="f.fear==l"][jiimp target=* 恐怖 ] [endif]¥ 

*door2 

[er]¥ 

[if exp=" f • fear==2" ] [ jump target 二 * 恐怖 ] [endif ]¥ 

*door3 

[er]¥ 

[if exp=" f . fear==3 " ] [jump target 二 * 恐怖 ] [endif ] ¥ 

•シナリオ記述例 

★start 

，•変数の初期設定 

[eval exp="f.doorl=0"]¥ 

[eval exp="f.door2=0"]¥ 

[eval exp="f.door3=0"]¥ 

[eval exp 二 " f.fear=intrandom(1,3)"]¥ 

f • 

★select 

[er]¥ 

どれを開ける？ [1] 

[nowait]¥ 

[if exp=" f .doorl==0"][link target=*doorl] 右の屝 [endlink] 
[r][endif]¥ 

[if exp="f .door2==0 H ][link target=*door2] 真中の扉 [endlink] 
[r][endif]¥ 


# # # 
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[if exp="'f .door3==0"][link target=*door3 ] 左の扉 [endlink] 

[r] [endif]¥ 

[endnowait]¥ 

[s] 


*doorl 

[er]¥ 

[if exp=" f. f ear==l"][jump targe t=* 恐怖 ] [endif ]¥ 
なにもない〇 [1] 

[eval exp= M f.doorl=l"]¥ 

[jump target=*select]¥ 

[s] 


★door2 
[er]¥ 

[if exp=" f. fear==2 " ] [ jump target=* 恐怖 ] [endif ]¥ 
なにもない 0 [1] 

[eval exp="f.door2=l"]¥ 

[jump target=*select]¥ 

[s] 


*door3, 

[er]¥ 

[if exp="f. fear==3" ] [jump target=* 恐怖 ] [endif ]¥ 
なにもない。 [1] 

[eval exp="f.door3 =1"]¥ 

[jump target=*select]¥ 

[s] 


★恐怖 

[er]¥ 

「ぎゃあああああああああああああああ！」 [1] 
( 恐怖の絵を見せてやってください ) [ 1 ] 













_ 
顯纏 _ 


KAG のシナリオは、書けば書くほどゴチヤゴチヤ 
してきますが、そんな時に便利な機能として準備 
されているのが「マク□定義機能」です。ここでは 
マク□の基本的な取り扱いについて解説します。 












マクロを活用する 





私の場合、マク 
口は本シナリオ • 
ファイル内ではな 
く 「 macro . ks 」 と 
いうファイルにす 
ベて記述しておき、 
それを ffirst.ksj 
の冒頭で [ call 】 タグ 
を用いて呼び出す 
ことにしています。 

つまり、 Step 6 で 
説明したサブルー 
チン化しているん 
です。 

こうすることで、 
マクロの定義を変 
更したいと思った 
場合、長い本シナ 
リオ内を探さなく 
ても 「 macro.ksj 
ファイル内を探せ 
ばすぐに見付かる 
ので、お勧めです。 


KAG の「マクロ」とは、複数のタグを一つのタグにまとめて自由に定義で 
きる機能のことです。たとえば、以下のようなトランジシヨン命令をシナリオ 
内に記述したとします。 


マク□の墨本的な使い方 


[trans time=2000 rule="transl.png" vague=100]¥ 
[wt] ¥ _ 


これがーヶ所だけならいいのですが、シナリオ中に100も200も出てくる場 
合に、そのたびに2行のタグ命令を記述するのは面倒です。 

「コピーすればいいじゃん」と思うかもしれませんが、後から rule ファイル 
を全部別のものに変更したいと思ったり、トランジション • タイムを変更した 
いと思った時には、記述されたタグを全て修正しなければなりません。 

「エディタで 一括置換をすれば一発じゃないか」と言う人は、シナリオ•フ 
ァイルが100も200もあった場合はどうしますか？ 

このような時は、上記の2行を [ macro ] [ endmacro ] タグを用いて、シナリオ 
の冒頭などでマクロ化しておくと便利なのです。 


•タグ記逋例 

[macro name 二新しいマクロの名前 ]¥ 
マクロ化したいタグ行 a 可行でもよい） 
[endmacro] ¥ 

•シナ II 才例 

*start 


[macro name=kinkae] ¥ 

[trans time=2000 rule="transl.png" vague=100]¥ 
[wt ] ¥ 

[endmacro]¥ 


*scene01 
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マクロの基本的な使い方 



この例の場合、 [ trans ] と [ wt ] の行が [ kirikae ] という名前の新しいマクロタグ 
に定義されました。以後は [ trans ] [ wt ] の2行で処理を行なう部分に、 [ kirikae ] 
というオリジナル.タグを使うことができます。 

このように マクロ を使えば、簡単にオリ ジナルのタグを 作れるので非常に便 
利ですが、使いすぎると困ったことになります。 

たとえば、 

[layopt layer=messageO page 二 back visible=false]¥ 

のような 1 行の記述をマクロにする意味はあまりありません。 

また、 

[layopt layer=messageO page=back visible=true]¥ 

[backlay]¥ 

の場合は、使い方によっては便利ですが、そうでない場合もあります。 

なぜなら、特にそれだけで完結していない処理をマクロに定義すると、前後 
の関係から再度それを分解しなければ処理を変更できないことが多いからです。 

完全にシナリオが書き上がった時点で同じ記述がされている行をマクロ化し 
て視認性を高めるならかまいませんが、例のようなケースは「どのような処理 
を行なっているのか」が分かりにくいため、マクロにしないほうがよいでしょ 
ぅ。 

ですが、短いタグでもマクロに定義したほうが便利な場合もあります。 


[playbgm storage="shock.mid" loop=falsej¥ 
[wb]¥ 


この例では、 「 shock 」 という名前の短い MIDI ファイルをループさせずに一 
度だけ鳴らす処理をしていますが、この場合は属性の変更はあり得ないのでマ 
クロ化するメリットがあります。 

マクロのメリットで最も大きい点は属性部分の値が完全に統一できることな 
ので、定型処理をマクロに登録しておけば、前回の処理を参考にして属性に 
同じ値を記述するような面倒を犯す必要はありません。 




KAG はオリジナ 
ルのタグを一切使 
わずにすべてを マ 
クロで処理するこ 
とも許しているの 
で、自分の ゲーム 
に見合った処理を 
行なうためのマク 
口はどんどん開発 
して使ってくださ 

い。 
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マクロを活用する 


■マクロに属性を与える 


下記の例のように、派手にマクロにしたいのに微妙な記述の違いがあって断 
念したことはありませんか？ 

_シナリオ例1 

[lavopt 1 ayer=message0 page=back visibie=false]¥ 

[image storage="dinner.jpg" layer=base page=back]¥ 

[trans time=2000 rule="transOl.png" vague=100]¥ 

[wt ] ¥ 

[layopt layer=messageO page 二 fore visible=true]¥ 


•シナリオ例 2 

[layopt layer=messageO page=back visible=false]¥ 

[image storage:"drive•jpg" layer=base page=back]¥ 
[trans time=2000 rule="trans01.png" vague=100]¥ 
[wt ] ¥ 

L 丄 ayopt layer=messageO page=fore visible=true]¥ 


•シナ 1 J 才例 3 

[layopt layer=messageO page=back visible 二 false]¥ 

Limage storage="forest.jpg" layer 二 base page=back]¥ 

[trans time=2000 rule="trans01.png" vague=100] 

[wt]¥ 

Llayopt 丄 ayer=messageO page=fore visible=true]¥ 

この例では、① [ image ] タグで画像を base レイヤーのバックグラウンドに読 
み込み、②2秒でトランジションさせ、③さらにその終了を [ wt ] で待ってか 
ら、④ [ layopt ] タグでメッセージレイヤーの フォア グラウンドを可視状態にす 
る——という一連の処理をしています。ここで異なるのは [ image ] タグの stor - 
age 属性だけですが、このように属性が異なるだけで他の一連の処理が同一の 
場合も、属性を引き渡すことによってマクロ化することができます。 

ただし、異なる指定がされている属性部分は マクロ 化できないた め、マクロ 
自体で属性を指定して、それを マクロ 内のタグに引き渡さねばなりません。 
先の例を マクロ 化するには、次のように記述します。 










7-1 


マクロの基本的な使い方 



春マクロ定義例 

[macro name=gamenkirikae] ¥ 一 

[layopt layer=messageO page=back visible=false]¥ 

[image storage=%storage layer=base page=back]¥ 

[trans time=2000 rule="transOl.png" vague=100]¥ 

[wt]¥ 

[layopt layer 二 messageO page 二 fore visible 二 true]¥ 

[endmacro]¥ 

[ image ] タグの storage 属性の部分に書かれた 「％ storage 」 という部分が、新 
しい [ gamenkirikae ] タグの storage 属性として利用できます。 

このマクロを使って最初の記述例を書き直すと、以下のようになります。 

•シナ U 才例1 

[gamenkirikae storage="dinner. コ pg"]¥ 

籲シナリオ例 2 

[gamenkirikae storage="drive•jpg"] ¥ 

•シナ U 才例 3 

[gamenkirikae storage="rorest•]pg"]¥ 

マクロ定義行で半角の％の次に指定されてい i 文字列がオリジナル.タグの 
属性として利用できるわけです。 

「 storage 」 ではややこしぐて嫌だという人は、次のように書いてもかまい 
ません。 

•マクロ定義例 

[macro name 二 gamenkirikae] ¥ 

[image storage=%gazou layer=base page=back]¥ 

[trans time=2000 rule 二 ,, transOl .png" vague=100]¥ 

[wt ] ¥ 

[layopt layer=messageO page=fore visible 二 true]¥ 

[endmacro] ¥ 
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マクロを活用する 


このようにマクロを定義しておくと、次のような記述で新タグが使えます。 

•タグ記述例 _— _ 

[gamenkirikae gaz 〇 u="dinner•jpg"]¥ — _ 

この場合は、 「 gazou 」 という属性に指定されたファイル名が [ image ] タグの 
storage 属性にそのまま渡されます。 

また、ルール.ファイルも使うたびに指定したい場合は、次のように定義し 
ます。 

•マクロ定義例 

[macro name=gamenkirikae] ¥ 

[image storage 二％ gazou layer=base page=back]¥ 

[trans time=2000 ru=%rule vague=100]¥ 

[wt ] ¥ 

[layopt layer=messageO page=fore visible 二 true]¥ 

[endmacro]¥ 

•タグ記述例 

[gamenkirikae gazou="dinner•jpg" ru="trans2.png"]¥ 

このように、マクロ定義タグ [ macro ] [ endmacro ] を利用すれば、タグだけで 
なく属性もオリジナルのタグを生成することができ、非常に便利です。 


I 選択肢をマクロ化する 


選択肢は、ノベルやアドベンチャーゲームになくてはならないものです。こ 
の部分をマクロ化すると、非常に便利です。 

その前に、まず選択肢の記述について考えてみます。次の例は、横書きの 
ノベル形式の選択肢です。 
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マクロの基本的な使い方 


Q 


•シナ u 才例 

[er]¥ ' 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[link target=*chapter0_scenel4] A. 天気がいつもこうだったらい 
いのに [endlink] 

[link target 二* chapter0_scenel5] B • 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C. 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 

[s] 


シンプルに書けばこのようになりますが、これでは選択肢としては中途半端 
です。そこで、選択肢の文字に対して以下のような表現を追加してみます。 

① 一瞬で表示されるようにする。 

② メッセー ジ履歴に残さないようにする。 

③ 画面の下端に表示する。 


①を可能にするには、 [ nowait ][ endnowait ] タグを用います。 


籲シナリオ例 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[nowait] ¥ 

[link target=*chapter0_scenel4 ] A. 天気がいつもこつだったらい 
いのに [endlink] 

[link target=*chapter0_scenel5] B. 車の調子がいつもこうたった 
らいいのに [endlink] 

[link target=*chapter0_scenel6 ] C . 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 

Lenanowait] ¥ 
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' 




さらに②を可能にするため、 [history] タグを用います。 

•シナリォ 例 __ 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[nowait] ¥ 

[history output = false]¥ 

[link target=*chapter0_scenel4] A. 天気かいつもこうたつたらい 
いのに [endlink] 

[link target=*chapter0_scenel5] B. 車の調子がいつもこうだつた 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C ■ 胃の調子がいつもこうだつた 
らいいのに [endlink] ¥ 

[history output=true] ¥ 

[endnowait] ¥ 


[history] タグはメッセージ履歴への文字の出力を制御するためのタグで、 「out¬ 
put 二 false」 と書いた時点から画面に書かれた文字はメッセージ履歴に出力されな 
くなります。元に戻すには、再び [history] タグを記述し、 「output=true」 とします。 

③を可能にするため、 [locate] タグで位置指定を行ないます。 

•シナ？ J 才例 

[er]¥ 一 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[locate y=365]¥ 

[nowait] ¥ 

[history output=false]¥ 

[link target=*chapter0_scenel4] A. 天気がいつもこうだったらい 
いのに [endlink] 

[link target=*chapter0_scenel5] B . 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C ■ 胃の調子がいつもこうだった 
らいいのに [endlink] ¥ 

[history output=true] ¥ 
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7-1 マクロの基本的な使い方 



これで、3っの選択肢を表示する記述は終了しました。続 t ゝてマクロ化してみます。 

•マクロ定義例1 

[macro name=select3] ¥ 

[locate y=365] ¥ 

[nowaitj ¥ 

[history output=false]¥ 

[endmacro]¥ 

•マクロ定義例 2 

[macro name 二 endselect]¥ 

[history output=true]¥ 

[endnowait]¥ 

[endmacro]¥ 

これで [ selects ] [ endselect ] という 2 つのオリジナル • タグが利用できるよう 
になりました。このオリジナル • タグを使って元のシナリオを書き換えてみます。 

•シナリオ例_ 

[er]¥ 

「言いなさいよ。言わないとサイドブレーキ引くわよ」 

[select3] ¥ 

[link target=*chapter0_scenel4] A. 天気がいつもこつたったらい 
いのに [endlink] 

[link target=*chapterO 一 scenel5] B _ 車の調子がいつもこうだった 
らいいのに [endlink] 

[link target=*chapter0_scenel6] C. 胃の調子がいつもこうたった 
らいいのに [endlink] ¥ 

[endselect] ¥ 
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1 ずいぶん すっきりしたと思います。ただし、このマクロでは、選択肢の数が 
3つのときにしか使えません。そこで、2つや4つの場合の [ select 2] や [selects 
もそれぞれ定義しておきます。 

•マクロ定義例 


r 


•マクロ定義例 

Lmacro name=select4] ¥ 
[locate y=345]¥ 

[nowait]¥ 

[history output 二 false]¥ 
[endmacro]¥ 


それぞれ画面下端に配置したいので、 [ locate ] で指定する Y 座標を文字サイ 
ズと行間サイズを考慮に入れて変更します。この値は 「 Config . tjs 」 の設定に 
よって変化するので、必ず確認してください。 

[ endselect ] は選択肢がいくつでも共通なので、個々に定義する必要はあり 
ません。1つ定義しておけば、すべての場合に利用できます。 

•シナリオ例 

[select2] ¥ 

[link target = *chapter0_scene22 ] A. 「ここで待つて I 、る力、し、？」 
[endlink] 

[link target 二 * chap terO 一 scene 2 3 ] B . 「一 緒 l こ行く 力、 I 、 ？ 」 
[endlink] ¥ 

[endselect] ¥ 

[s] 


[macro name=select^]¥ 

[locate y=385]¥ 

[nowait]¥ 

[history output 二 false]¥ 
[endmacro] ¥ 










7-1 マクロの基本的な使い方 


幽 


さらに、選択肢そのものをマクロ化することも有益です。 

ボタンやリンクの上にマウス.カーソルが乗ったりクリ ック したりすると音 
が出るソフトがありますが、 KAG の [ link ] タグでも同様のことができます。 

_シナリオ例 

[select2]¥ 

[link enterse="otol.wav" clickse="oto2.wav" target= 
*chapter0_scene22] A _ 「ここで待つているかい？」 [endlink] 

[link enterse="otol.wav" clickse="oto2.wav" target 二 
*chapter0_scene23 ] B ■ 「一緒に行く かい？」 [endlink] ¥ 

[endselect] ¥ 

[s] 


[ link 】 タグの属性に「 enterse = ?, カーソルがフォーカスしたときの音ファイル 
名 n 」 と 「 clickse =” クリックしたときの音ファイル名 n 」 を指定してやれば、こ 
の選択肢は音っきになります b 

でも、すべての選択肢に上の例のような書き方をしていると、見にくいです 
よね。そこで、マクロを使います。 

•マクロ定義例 

[macro name=links] ¥ 

[link enterse="otol.wav" clickse 二 " oto2•wav" 
target=%target]¥ 

[endmacro] ¥ 

[ link ] に sound を付けたということで、 [ links ] タグを作ってみました。これ 
でシナリオ例を置き換えると、次のようになります。 

•シナリオ例 

[select2]¥ 

[links target = *chapterO—scene22 ] A • 「ここで待っているかい？」 
[endlink] 

[links targe t: * chapter 0_scene2 3 ] B ■ 「一緒に行く かい？」 
[endlink] ¥ 



129聲 








マクロを活用する 


_ 6 _ 

-ベ 、 


私の場合 、 「[call 
storage =" macro.ks 
" target =* start ]¥」 
の1行をエディタ 
の シヨー トカット 
に登録してあり、 
必要に応じて呼び 
出しています。 

シナリオを書い 
ていて、もしマク 
口に修正が入った 
場合は、①上の1 
LifTiJ 行を本シナリオに 
仮 害き 込みしてマ 
クロ定義部分を実 
行し、②その後セ 
ーブデータを保存 
してから、③上の 
1行を削除してシ 
ナリオを元の状態 
,に戻しています。 

I シナリオが長く 
なってくると first.ks 
部からのリブレイ 
は現実的ではない 
ので、任意の場所 
からマクロ定義フ 
アイルを呼べる状 
態にしているわけ 
です。 




[endselect] ¥ 
[s] 


ここで注意ですが、 [ links ] タグから [ link ] タグの属性に引き渡す内容は、こ 
の場合は 「 target 」 のみとなっています。シナリオ内でジャンプするだけなら 
これで充分ですが、私の場合は、下記のように [ links ] タグを定義しています。 


[macro name=links]¥ 

[link enterse="otol.wav" clickse= 
target=%target exp=%exp]¥ 
[endmacro]¥ 


"oto2.wav" storage=%storage 


ジャンプ先のラベルを指定する target 属性だけでなく、ファイル間ジャンプに 
利用する storage と変数を処理するための exp 属性も引き渡すようにしています。 

このようにしておけば、いざ 「 storage 」 や 「 exp 」 を使いたくなったときにも、 


[links storgae="xmaseve02.ks" target=*chapter2_scene0_set 
exp="f.hensuu=l"]¥ 


のように記述できるからです。 

このような定義をしておかないと、使えると思ったはずの属性が使えないこ 
とになったりするので、注意してください。マクロの属性がうまく効いていな 
いと思ったら、マクロの定義記述が間違っていることを疑うとよいでしょう。 

また、 マクロの 記述データはセーブ.データに保存されるので、 マクロを 定義 
する前のセーブ•データをロードした場合、定義した マクロが 使えな t ゝ場合が 
あります。これは、すでに定義した マクロの 内容を修正した場合も同様です。 

このような場合には、もう一度マクロの定義行を通過する形でリプレイしな 
いと、修正部は発動しません。 
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アドベンチャー形式のゲームのように、画面の一部 
をク U ックすると反応があるような作品を作0たけ 
れぱ、 この「クリッカブル•マップ」を利用します。 






ツカブル • マップの利用 



ク U ッカブ • マップの作成方法 


「クリッカブル•マップ」とは、画像の一部分をクリックしたらの指定のラ 
ベルにジャンプすることを可能にするものです。 

これ冬「吉里吉里/ KAG 」 で実行するには、以下の3つのファイルが必要です〇 


ファイル 


ベース画像 


名爾めつけ方 
任意のファイル名.拡張子 


領域画像 

任意のファイル名 _p.png 

領域アクション定義ファイル 

任意のファイル名. ma 


《ベース画像》 

これは、普通の画像ファイルで、 「 base レイヤー」「前景レイヤー」のどち 
らにでも読み込むことができ、ファイル形式も自由です。「前景レイヤー」に 
読み込んで利用する場合は画像サイズについては任意ですが、 「 base レイヤー」 
に読み込んで利用する場合は 「 Config . tjs 」 で指定された画面サイズと等しい 
ものを利用する必要があります。 



ベース画像例： exitpng 


《領域画像》 

これは、ベース画像のクリック領域を色分けしたもので、256色の PNG ファ 
イルでないといけません。256色が取り扱えるフリーソフトなどを利用してべ 
ース画像の形状を元にクリック領域をそれぞれ単色で塗りつぶしていくのです 
が、このときカラーパレットのインデックス番号が1の色から使う必要があり 
ます。 


• 132 









この例では、パレットの左側から順番に「0」「1」「2」というパレット•イ 
ンデックス番号がついています。このため、青は「1」、水色は「2」、ピンクは 
「3」、黄緑は「4」、黄色は「5」、そして赤が「6」になります。このパレット 
インデックス番号は後述の領域アクション定義ファイルに利用するので、きち 
んと把握しておぐ必要があります。 




《領域アクシヨン定義フアイ)レ》 

中身は以下のようになっています。 


y hint =•' 非常口"； storage^"first.ks"; target 二 " *scene0l"; 

2 : hint=' '窓"； storage^ " first.ks "; target: " *scene02 "; 

3 : hint= n 天井"； storage^" first. ks "; target 二"* scene03 " ; 

4 : hint="M(7)li" ； storage=" first. ks" ； target^" *scene04 "； 

5 : hint= " 非常口のガラス " ； storage:" first .ks"; target =" *scene05 

6 : hint =" 教室の扉"； storage:" first .ks"; target:" *scene06"; 
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クリツカブル • マップの利用 


それぞれの行の構成は「領域番号（半角の「:」）アクション」で構成されて 
いますが、行頭にある「1」から「6」までの数字が領域画像で塗った色のパ 
レット番号になります。 

青色で塗ったのは「非常口の扉」なので1行目に、水色で塗ったのは「窓」 
なので2行目に、というように色のパレット番号に合わせてジャンプ先のファ 
イルやラベルを記述していきます。 

アクションについては KAG の説明からはやや外れますが、「属性名=値；」 
とう形式でいくつでもつないで書くことができます。 


•アクション記逑例 



クリックされたときにジャンプするファイル名を指定。 


クリックされたときにジャンプするラベル名を指定。 


領域内にカーソルが入つたときに実行する TJS 式を指定。 


領域内からカーソルが出たときに実行する TJS 式を指定。 


マウスが乗つたときに表示される文字列を記述。 


変数処理や、 TJS 機能の呼び出しなどの TJS 式を指定。 


マウスカーソル • ファイルやマウスカーソル定数を指定。 


以上の3つのファイルを同一のフォルダに入れれば、クリッカブル.マップ 
の準備は完了です。背景画像をクリッカブル • マップとして利用するなら 
「 bgimage 」 フォルダへ、前景画像なら 「 fgimage 」 フォルダへ入れましょう。 
「 other 」 でもかまいません。 

続いてシナリオ.ファイルでクリッカブル.マップを呼び出す記述を行ない 
ますが、これは [ image ] タグで行ないます。ベース画像と同名の 「_ p . png 」 
と. ma ファイルが存在すれば、ベースとなる画像を [ image ] タグで普通に呼び 
出しただけでクリッカブル.マップが利用できます。 


•タグ記述例 

layer=base page=fore st-oraae=：-exit ,pna» ]¥ 
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マップの作肪法| 


KAG 


•シナリオ記逑例_ 

*start 

[er]¥ 

[image layer=base page=fore storage="exit.png"]¥ 


*scene01 

[er]¥ 

非常口は鍵が掛かっていて、押しても引いても開かなかった。 [1] 

[jump target=*start]¥ 

[s] 


*scene02 

[er]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 

[jump target=*start] ¥ 

[s] 


*scene03 

[er]¥ 

天井 …… そこは調べようがない。 [1] 

[jump target=*start]¥ 


*scene04 

[er]¥ 

非常口の扉がついている奧の壁はコンクリートでできていた。 [1] 

[jump target=*start]¥ 


*scene05 

[er]¥ 

非常口のガラスはワイヤーメッシユの入った強化ガラスで、その上模様が入 
っているので向こう側の様子はわからない。 [1] 

















[er]¥ 

先ほど来た時にひどい目に遭った 3 年 2 組の教室へ入る扉だ。 [1] 
[jump target=*start] ¥ 


クリツカブル • 
マツプはアドベン 
チヤーゲームでは 
必須の機能ですが、 
シナリオに [ link ] 夕 
グが1つもないの 
に分岐処理が行な 
えるので、ちよつ 
と不思議な感じが 
しませんか？ 


先ほどの例では、それぞれのジャンプ先から [ jump ] タグを使ってクリッカブ 
ル•マップ表示部分に戻っていましたが、これは「領域番号0」を使った特殊 
な指定をすることにより、シナリオを大幅に改善することができます0 
具体的な方法ですが、領域アクション定義ファイル内に「領域番号0」を記 
述し、次のように記述します。 


― • 136 




















_ 蘇:..ヽへ.: 1 

.'..• :人：':ン.ノ; 

人) r : 義 

_議_ 

?:讀以::，ベ 






クリツカブ)レ•マツプの作成方法 

-: ' '' I 


*sceneOJ 


•領域アクション定義ファイル例 rexit.maj 

0: autodisable=ralse ； 

1: hint=" 非常口"； storage^"first.ks"; target="*scene01"; | 

2 : hint 二 " 窓 " ； storage:"first•ks"; target 二 "* scene02 H ; 

3: hint= " 天井 " ； storage:" first • ks"; target=" *scene03 "； 

4 : hint= " 奧の壁 , ’ ； storage=" first. ks" ； target=" *scene04 "； 

5 : hint 二 " 非常口のカラス " ； storage="first .ks"; target= 

"*scene05"; 

6: hint =" 教室の扉 ", • storage 二 " first•ks"; target="*scene06"; | 

1 行目に「領域番号0」の行を加えることにより、クリッカブル•マップを 
クリックしても、クリッカブル•マップは無効になりません。 

先の例ではこの指定を行なわなかったため、それぞれのジャンプ先から再び 
ラ ベル restart ] へ 戻り、 [ image ] タグによるクリッカブル•マップ画像のロー 
ドを行なっていましたが、「領域番号0」の行を加えることで不要になります。 


•シナ U 才記述例 


^start 


[image laver=base page=fore storage="exit.png"]¥ 


★sceneOl 

へ. .• > • 

[er]¥ へ 

非常口は鍵が掛かっていて、押しても引いても開かなかった 。 ' [1] 


*scene02 

[er]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 
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參 

參 


天井……そこは調べようがない。 [1] 


*scene04 

[er]¥ 

非常口の扉がついている奥の壁はコンクリートでできていた。 [1] 


*scene05 

[er]¥ 

非常口のガラスはワイヤーメッシュの入った強化ガラスで、その上模様が入 
っているので向こう側の様子はわからない。 [1] 


*sceneOb 

[er]¥ 

先ほど来た時にひどい目に遭った3年2組の教室へ入る扉だ。 [1] 


このように [ jump ] タグをそれぞれのジャンプ先に置かなくても、常に画像が 
表示されている間はクリッカブル • マップが有効になっているため、別の領域 
をクリックすることができるのです。 


ップの条件分岐 


[ if ] タグと同様に、クリッカブル • マップでも変数などの条件によって有効 
にしたり無効にしたりできます。 

基本的にクリッカブル.マップではアクションが何も定義されていなければ 
その領域は無視されます。これを応用して、一度クリックして調べた場所は次 
からクリックできないようにしてみます。 


















越 ___ 圓^ 男_:匯 


• exit . ma 記述例 
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, ^ ； • ハ . '- iWGt:〆 ： の 

參⑩_ _ 


0 : autoaisable=false ； 

1: if (f . scOl!=1){hint= "非常口"； storage:" first .ks"; target 
="*scene01";} 

2: if (f • sc02 !=1){hint= •• 窓 " ； storage=" first.ks" ； target 
="*scene02"；} 

3 : if (f • sc03 !=1){hint= "天井"； storage 二 " first • kstarget 

="*scene03";} 

4 : if (f • sc04 !=1){hint 二"奥の 壁"； storage="first .ks"; target 

="*scene04";} 

5 : if (f • sc05 !=1){hint= "非常口のガラス"； storage:" first • ks" 

target="*scene05";} 

6 ： if (f .sc06!=l) {hint= "教室の 扉 "; storage="first.ks"; 
target="*scene06"；} 


•シナリオ例 






*start 

[er]¥ 

[image layer=base page=fore storage="exit.png"]¥ 


*scene01 

[er]¥ 

[eval exp="f.sc01=l"]¥ 

非常口は鍵が掛かっていて、押しても引いても開かなかった。 [1] 


*scene02 

[er]¥ 

[eval exp="f.sc02=l"]¥ 

窓からは外の光がうっすらと差し込んでいる。 [1] 


囑 

_議_ 
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# 


*scene03 

[er]¥ 

[eval exp="f.sc03=l"]¥ 

天井……そこは調べようがない。 [1] 
[s] 


*scene04 

[er]¥ 

[eval exp="f•sc04=l"]¥ 

非常口の扉がついている奥の壁はコンクリートでできていた。 [1] 
[s] 


*scene05 

[er]¥ 

[eval exp="f.sc05=l"]¥ 

非常口のガラスはワイヤーメッシュの入った強化ガラスで、その上模様が入 
っているので向こう側の様子はわからない。 [1] 

[s] 


*sceneOb 

[er]¥ 

[eval exp="f.sc06=l"]¥ 

先ほど来た時にひどい目に遭った 3 年 2 組の教室へ入る扉だ。 [1] 
[s] 


領域アクション定義の行で、 if ( f . 変数名!=1){アクション}という記述をする 
ことにより、 「 f . 変数名」が「1」でない場合は{アクション}を実行するように 
してあります。 

そして、それぞれのジャンプ先で [ eval ] タグにより 「 f •変数名」に「1」が代 
入されることによって、再び KAG シナリオが領域アクション定義の行を参照 
しても{アクション}は実行されなくなるわけです。 
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■クリッカプル • マップを使い終えたら 


クリッカブル.マップを伴う画像が存在していると、シナリオはキーボード 
による マウスエ ミュレ ーシ ョン. モー ドで実行されます。 

これには弊害があり、 edit タグのようなキーボードを用いるほかの機能が正 
常に動作しなくなるので、クリッカブル • マップは使用を終えた後できちんと 
片付ける必要があります。 


•シナリオ例 

[mapdisable layer 二 base page=fore] ¥ 

base レイヤーに読み込んだ背景画像は上のような記述でクリッカブル•マッ 
プを無効化しておきます。 

前景レイヤーに読み込んだ場合は、その画像を引き続き使う必要がないなら、 
[ freeimage ] タグを利用してクリッカブル•マップを画像もろとも破棄します。 


•シナ U 才例 



この [ freeimage ] タグはアニメーションする前景画像を開放する場合にも利用 
できます。特にアニメーション.ファイルは 「 page = back 」 などに置いたまま 
にしておくとメモリを無駄に消費するので、必ずこのタグを用いて開放してお 
きましよう。 

また、クリッカブル.マップを持つ画像がロー ドされているレイヤーに別の 
画像をロードしてもクリッカブル•マップは解放されて消えます。 

クリッカブル.マップを base レイヤーに背景として読み込んでいる場合は、 
次に表示する背景画像を読み込めばクリッカブル • マップは自動的に無効にな 
るので、トラブルは少ないです。しかし、前景レイヤーに使っている場合には 
解放を忘れることがあるので、注意してください。 
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クリッカプル•マップを 15 用した CG ギヤラ U - 


クリッカブル.マップの機能を応用することにより、一度見た画像はサ厶ネ 
イル表示し、見ていない画像は「？」の描かれた真っ黒な矩形などで表示す 
る CG ギャラリーを作ることができます。もちろん、サムネイルをクリックす 
ると原寸の CG を表示するものです。 



このような CG ギャラリーを作成するには、以下のような処理をシナリオ化 


することが必要になります。 


① 本シナリォ内で任意の CG を見た時、それを変数に記憶。 

② CG ギャラリーのメニューで変数をチェックし、見た CG のみをサムネイル表示。 


ここまでは、変数と [ if ] 分岐を利用すれば組み上げることができます。 

もし、扱われているイベント CG の枚数があまりにも多くて変数を1つずつ定義 
するのが面倒な場合は、変数名を直接 CG ファイル名から得ることもできます。 

この場合、一度でもゲーム内で表示した（つまりプレイヤーが見た）画像を 
記録するために以下のようなマクロを定義し、 CG アルバムに掲載する画像は 
通常の [ image ] タグではなく、このオリジナル.タグで表示します。 

_マクロ定義例 

[macro name=imagemem] ¥ 

[image *] ¥ 

[eval exp="sf[mp.storage]=1"]¥ 

[endmacro] ¥ 
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この [ image ] タグに毛が生えたような [ imagemem ] タグを利用してゲーム内で 
CG を表示すると、下のシナリオ例の2行目にコメントとして記述されている 
ような [ eval ] タグを用いた変数定義が自動的に行なわれます。 

変数名には [ imagemem ] タグでロードした画像データのファイル名が利用さ 
れ、その値には自動的に「1」が入ります。 

_シナリオ例_ 

[imagemem storage:"picOl.jpg"layer=base page=fore]¥ 

;[eval exp="sf.pic01=l"]¥ 


ここまでで、シナリオ内で表示した画像については、画像を表示するとその 
画像ファイル名をもつ変数が生成され、値に「1」が代入されることになりま 
した。 

続いて、 CG ギャラリーのメニューページを作りますが、考え方は以下のよ 
うになります。 


① すべてのイベント CG のサムネイルを並べた1枚の画像を作成し、 base レイ 
ヤーのフォアグラウンドにロー ドする。 

② [ laycount ] タグにより、イベント CG の数だけ前景レイヤーを準備する。 

③ それぞれの前景レイヤーに「まだ見ていません」というサムネイルと同サイ 
ズの画像を読み込み、 base レイヤー上の個々のサムネイルを覆い隠す。 

④ それぞれの前景レイヤー上に読み込まれた「まだ見ていません」という画像 
を、シナリオ内部で得た変数の値を元に管理する。具体的には、変数が「0」 
の場合は覆い隠したままにしておき、「1」の場合には取り払う。 

⑤ 「まだ見ていません」画像が取り払われた場合、クリッカブル•マップが有 
交力になり、 base レイヤー上のサムネイルをクリックすると、そのサムネイル 
からリンクしている原寸の元]@像を画面に表示する。 


[ laycount ] は、メッセージ.レイヤーや前景レイヤーなど、動的に数が変更 
される可能性のあるレイヤーの現在の利用数を指定するためのタグです。 


CG ギャラリーを 
作るために必要な 
前景レイヤーの数 
は base レイヤーに 
並べて1枚絵とし 
て表示したサムネ 
イルの総数に等し 
くなります。 

たとえば4 X 
4=16枚の CG サム 
ネイル画面を作る 
場合には前景レイ 
ヤーは16枚必要に 
なりますが、この 
程度ならば特に問 
題はありません。 

W . Dee さんは 
「サイズが小さい前 
景レイヤーなら、 
数十枚同時に利用 
してもさほど問題 
にならない」と言 
L ってし、ます。 J 
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呢述例 _ 

[laycount messages=2 layers=lOj¥ 
[laycount messages=l layers=0]¥ 


[ laycount 】 タグで 
じ) 1 メッセージレイヤ 
こ:一数を指定する場 
合、 message =0 と 
いう指定はできま.： 
せん。メッセージ 
ごへレイヤーは最低で 
巧ミ:も常に1枚存在す 
る状態でなければ 
X ミならないからです。 
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上の例ではメッセージ.レイヤーを2枚と前景レイヤーを10枚準備してお 
り、下の例ではメッセージ • レイヤーを最小数の1枚にし、前景レイヤーはす 
ベて破棄しています。 

また、メッセージ•レイヤーのみ、前景レイヤーのみを指定することもできます。 

•記逋例 

[laycount messages=2] ¥ 

[laycount layers=10]¥ 

以下に、 16 X 16 のサムネイルを「？」の画像で隠しておき、シナリオ内で 
見た画像だけサムネイルを表示するシナリオを書いてみます。 

•シナリオ例 

*start 

[position layer=messageO left=0 top=0 width=640 
height=480 opacity=150]¥ 

[layopt 1ayer=message0 page=fore visible=true]¥ 

/ 

; すべての変数を 0 にします。 

[eval exp="sf.pic01=0"] ¥ 

[eval exp="sf.pic02=0"]¥ 

[eval exp="sf.pic03=0"]¥ 

[eval exp="sf.pic04=0 H ]¥ 

[eval exp="sf.pic05=0"]¥ 

[eval exp="sf.pic06=0"]¥ 

[eval exp="sf.pic07=0"]¥ 

[eval exp="sf.pic08=0"]¥ 

[eval exp="sf.pic09=0"]¥ 

[eval exp="sf.picl0=0"]¥ 

[eval exp="sf.picll=0"]¥ 
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[eval exp="sf.picl2=0"]¥ 

[eval exp="sf.picl3=0"]¥ 

[eval exp="sf.picl4=0"]¥ 

[eval exp="sf.picl5=0"]¥ 

[eval exp="sf.pic16=0"]¥ 

/ 

，•以下の行は本来なら各シナリオで CG を見た時に 1 になるシステム変数です。 
， • ここではデバッグの意味もあり、 16 個の変数を手動で操作します。 

; 本来はこれらの変数は先に定義した [imagemem] タグで管理します。 

， • 見たことにしたい画像の行から先頭のセミコロンを外してみてください。 

； [eval exp="sf.pic01=l"]¥ 

[eval exp="sf.pic02=l"]¥ 

;[eval exp="sf.pic03=l"]¥ 

;[eval exp="sf.pic04=l"]¥ 

;[eval exp="sf.pic05=1"]¥ 

[eval exp 二 " sf.pic06=l"]¥ 

[eval exp="sf.pic07=1"]¥ 

[eval exp="sf.pic08=1"]¥ 

;[eval exp="sf.pic09=1"]¥ 

； [eval exp 二 " sf.picl0 = l"]¥ 

[eval exp="sf.picll=l"]¥ 

;[eval exp="sf.picl2=l"]¥ 

；[eval exp="sf.picl3=l"]¥ 

;[eval exp="sf.picl4 = l"]¥ 

[eval exp="sf.picl5=l"]¥ 

;[eval exp="sf.picl6 = l"]¥ 

[link target 二 * eg—room] CG ギャラ 1 J— へ行く [endlink] ¥ 

[s] 


*cg_room 

[er]¥ 

/ 

;16 X16 のサ厶ネイルが並べられた 1 枚の画像を base レイヤーに表示します。 
[image storage 二 ,, allpic .bmp" layer 二 base page=fore] ¥ 
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I 

I 

♦ 

/ 

，•前景レイヤーを 17 枚にします。 

[laycount layers=17] ¥ 

i 

，•全ての前景レイヤーを見えるようにします。 

[layopt layer=0 page=fore visible=true]¥ 
[layopt layer=l page=fore visible=true]¥ 
[layopt layer=2 page=fore visible 二 true]¥ 

[layopt layer=3 page=fore visible=true]¥ 

[layopt layer=4 page 二 fore visible=true]¥ 

[layopt layer=5 page=fore visible=true]¥ 

[layopt 丄 ayer=6 page=fore visible=true]¥ 
[layopt layer=7 page=fore visible=true]¥ 

[lay opt layer=8 page=fore visible=true].¥ 
[layopt layer=9 page=fore visible=true]¥ 

[layopt layer=10 page=fore visible=true]¥ 
[layopt layer=ll page=fore visible=true]¥ 
[layopt layer=12 page=fore visible=true]¥ 
L 丄 ayopt layer-13 page=fore visible=true]¥ 
[layopt layer=14 page=fore visible=true]¥ 
[layopt layer=15 page=fore visible=true]¥ 


，•それぞれの前景レイヤーに「？」マークの画像を置きます。 

，•この画像はシステム変数によって表示されたりされなかったりします。 

[image storage^"notyet.bmp"layer=0 page=fore left=0 
top=0 cond="sf.pic01==0"]¥ 

[image s^o l ^feyet •bmp" layer=l page=fore left=160 
top=0 cond="sf.pic02==0"]¥ 

[image storage 二 " notyet.bmp" layer=2 page=fore left=320 
top=0 cond="sf.pic03==0" ]¥ 

[image storage:"notyet.bmp"layer=3 page=fore left=480 
top=0 cond="sf.pic04==0"]¥ 

[image storage 二 " notyet•bmp"layer=4 page=fore left=0 
top=120 cond="sf.pic05==0"]¥ 
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KAG 


[image storage^"notyet.bmp" layer=5 page=fore left=160 
top=120 cond="sf.pic06==0"]¥ 

[image storage^"notyet.bmp" layer=6 page=fore left=320 
top=120 cond="sf.pic07==0"]¥ 

[image storage^"notyet.bmp"layer=7 page=fore left=480 
top=120 cond="sf.pic08==0"]¥ 

[image storage^"notyet.bmp"layer=8 page 二 fore left=0 
top=240 cond="sf.pic09==0"]¥ 

[image storage^"notyet.bmp"layer=9 page=fore left=160 
top=240 cond="sf.picl0==0"]¥ 

[image storage="notyet.bmp" layer=10 page=fore left=320 
top=240 cond="sf.picll==0"]¥ 

[image storage="notyet.bmp" layer=ll page=fore left=480 
top=240 cond="sf.picl2==0"]¥ 

[image storage="notyet.bmp"layer=12 page=fore left=0 
top=360 cond="sf.picl3==0"]¥ 

[image storage="notyet.bmp" layer=13 page=fore left=160 
top=360 cond="sf.picl4==0"]¥ 

[image storage="notyet.bmp" layer=14 page=fore left=320 
top=360 cond="sf.picl5==0"]¥ 

[image storage 二 " notyet•bmp"layer=15 page=fore left=480 
top=360 cond="sf.picl6==0"]¥ 

[link target=*return_start] スーユーに民る [endlink] ¥ 

[s] 

/ 

， • メニューに戻るために前景レイヤーを 0 にし、黒い画像を base に読み込み 
ます。 

*return_start 

[er]¥ 

[laycount layers=0]¥ 

[image storage^"black.png"layer=base page=fore]¥ 

[jump target=*start]¥ 

[s] 


______ 






[ image ] タグの末 
尾にある cond 属性 
は、 [ if ] タグと同じ 
働きをします。 
「 cond =」 の後ろに 
書かれた評価式が 
“真”の場合、つま 
り式を満たしてい 
るときのみ 、 cond 
属性が記述されて 
いるタグが実行さ 
れるようになりま 
す0 

この場合は 
__ sf . pic 0 x ==0__ です 
から、指定のイべ 
ント CG を見ていな 
い場合に [ image ] 夕 
グが実行され、「？」 
マークの 描かれた 
黒い矩形が表示さ 
れてサムネイルを 
覆い隠しています。 

cond 属性はほと 
んどのタグに利用 
できるので、 [ if ] 夕 
グを充分に理解で 
きたら使ってみる 
とよいでしよう。 
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クリツカブル•マップの利用 

肇 

• II 


; それぞれのクリッカブルマップがクリックされた時にジャンプする先です。 
; 本来はここで原寸の CG を表示します。 

*pshow01 

[er]¥ 

1 番目の画像がクリックされました。 

[s] 

*pshow02 

[er]¥ 

2 番目の画像がクリックされました。 

[s] 

*pshow03 

[er]¥ 

3 番目の画像がクリックされました。 

[s] 

*pshow04 

[er]¥ 

4 番目の画像がクリックされました。 

[s] 

*pshow05 

[er]¥ 

5 番目の画像がクリックされました。 

[s] 

*pshow06 

[er]¥ 

6 番目の画像がクリックされました。 

[s] 

*pshow07 

[er]¥ 

7 番目の画像がクリックざれました。 

[s] 

*pshow08 

[er]¥ 

8 番目の画像がクリックされました。 







*pshow09 

[er]¥ 

9 番目の画像がクリックされました。 
[s] 

*pshowlO 

[er]¥ 

10 番目の画像がクリックされました 
[s] 

★pshowll 

[er]¥ 

11 番目の画像がクリックされました 
[s] 

*pshowl2 

[er]¥ 

12 番目の画像がクリックされました 
[s] 

★pshowl3 

[er]¥ 

13 番目の画像がクリックされました 
[s] 

*pshowl4 

[er]¥ 

14 番目の画像がクリックされました 
[s] 

*pshowl5 

[er]¥ 

15 番目の画像がクリックされました 
[s] 

★pshowl6 

[er]¥ 

16 番目の画像がクリックされました 


麵 

: 

参論 I 

I 

I 
I 

|i . 議 :_ 




クリツカブル • マップの利用 


続いて領域アクション定義ファイルの内容です。 

•領域アクション定義ファイル 「 allpic . maj 記述例 


0: 

autodisable=false ； 


1: 

if(sf. 

pic01==l){storage="first.ks ”； 

target="*pshow01";} 

2 : 

if(sf. 

pic02==l){storage:"first.ks "； 

target="*pshow02"；} 

3 : 

if(sf. 

pic03==l){storage="first.ks"; 

target="*pshow03";} 

4: 

if(sf. 

pic04= 二 1){storage="first.ks"; 

target 二 " *pshow04";} 

5: 

if(sf. 

pic05==l){storage="first.ks"; 

target="*pshow05"；} 

6: 

if(sf. 

pic06==l){storage="first.ks"; 

target="*pshow06"；} 

7: 

if(sf. 

pic07==l){storage:"first.ks "； 

target= M *pshow07"；} 

8 ： 

if(sf. 

pic08==l){storage="first.ks"; 

target="*pshow08"；} 

9: 

if(sf.pic09 二 =1){storage="first.ks"; 

target 二 " *pshow09"；} 

10 

if (sf 

•picl0==l){storage="first.ks" 

;target="*pshowl0" ； } 

11 

if (sf 

• picll==l){storage=" first:. ks" 

;target="*pshowll";} 

12 

if (sf 

•picl2==l){storage="first•ks" 

;target="*pshowl2" ； } 

13 

if (sf 

.picl3==l){storage= "first:. ks" 

;target="*pshowl3" ； } 

14 

if (sf 

• picl4==l){storage=" first;. ks" 

;target="*pshowl4";} 

15 

if (sf 

• pic 15== 1){storage=" first:. ks" 

;target="*pshowl5" ； } 

16 

if (sf 

.picl6==l){storage:"first.ks" 

;target="*pshowl6" ； } 


システム変数が「1」のときに first . ks 内のそれぞれのラベルにジャンプする 
処理を指定しています。 


あとは、サムネイルの並んだベース • ファイルとクリッカブル.マップの令頁 
域定義ファイルを用意すれば完成です。 



ベース•ファイル 領域定義ファイル 

















スタッフ ロールの 作り方や、雪や雨を降5せるな 
ど、 KAG 3 で提供されている面白いプラグインの 
利用方法を中心に、さまざまな機能を解説します。 






その他の機能 


. 



ED 


スキップ状態を細限す 


r r 〆 

• r 


r 吉里吉里」のシステム•メニューには、「次の選択肢/未読まで進む」と 
いうコマンドがあります。これをクリックすると、一度見た文章や画像はゥエ 
イトのない状態で高速に表示されます。また、メッセージが表示されている途 
中で画面をクリックすることによって、クリック待ち部分まで一'気に文章を表 
示する機能もあります。これらの状態を「スキップ状態」と言います。 


KAG のほとんどのタグは、このスキップ状態を許可しています。これは「ユ 
ーザーを待たせるような処理については、入刀があった場合はどんどんスキッ 
プする」という仕様が標準になっているからです。 

ですが、作品を作っていると、ヒントなどが隠された重要な画像を表示する 
ためのトランジション や、 制限時間がついている選択肢など、 ユーザーが 処理 
をスキップしてしまうと都合が悪いものもあります。 

このような状況下でスキップ状態を強制的こ止めたい場合は、 [cancelskip] 
というタグを用います。 

《キャンセル • スキップ [ cancelskip ]》 

以下は、トランジションの手前で強制的にスキップ状態を解除するシナリオ 
例です。 

•シナリオ例 _ 

；•背景画像切り替え用のマクロ 

[macro name=kirikae] ¥ 

[cancelskip] ¥ 

[image storage=%storage layer=base page=back]¥ 

[trans method 二 crossfade time=1000]¥ 

[wt]¥ 

[layopt layer=messageO page-fore v:Lsible=true] ¥ 

[endmacro]¥ 


このようにマクロ化しておけば、数あるトランジシヨンの手前に [cancelskip] 
タグを1つずつ書く手間が省けます。 





9-1 スキップ状態を制限する 


《クリック • スキップ [ clickskip ]》 

[ cancelskip ] によって一度は解除されたスキップ状態も、ユーザーが再度「次 
の選択肢/未読まで進む」コマンドを選んだり、エンター•キー押下などのァ 
クシヨンを起こした場合には、再びスキップ状態に入ってしまいます。このよ 
うなことを避けるためには、スキップ機能をいったん停止させるだけではな 
く、その機能自体を無効にしてしまえばよいのです。このようなときに利用す 
るのが、 [ clickskip ] タグです 0 

•タグ記述例 

[clickskip enabled 二 false] 草 
[clickskip enabled=true] ¥ 


上の例でクリック•スキップ自体を禁止し、下の例で再びクリック.スキッ 
プできるように許可しています。クリック-スキップの禁止状態は同じ [ click - 
skip 】 タグでないと解除できないので、 「 enabled = false 」 で禁止にした後は、必 
ず 「 enabled = true 」 で解除します。 

•シナリオ例 

，•參背景画像切り替え用のマ M 

[macro name=kirikaej ¥ 

Lcance 丄 skip] ¥ 

[clicksKip enabled=fa 丄 se]¥ 

[image storage^%storage layer 二 base page^back]¥ 

[trans method=crossfade time=1000]¥ 

[wt ] ¥ 

[layopt layer=messageO page=fore visible=true]¥ 

[clickskip enabled=true]¥ 

[endmacro] ¥ 

このようにしておけば、どのようなモードでトランジシヨンまで読み進めて 
きても自動的にいったん停止し、トランジシヨンが終了するまではクリック • 
スキップが無効になります。 
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厂士里士宁 

1/ KAG 2 J の時代に 
は 『 move ] タグを利 
用した非常に複雑 
なシナリオを書か 
ねば、スタッフロ 
ールは作れなかつ 
たのです。 

あの時代のこと 
を思うと、今はず 
いぶん楽になりま 
した。 




スタッフロール +作る 


ここでは、映画やドラマの最後に流れる「キャストロール」や「スタッフロ 
ール」を作ってみます。「吉里吉里/ KAG 」 には、これらスタッフロールを利 
用するための専用プラグイン.サンプルが提供されているので、これを利用す 
ればすぐにできます。 

《プラグイン》 

「 KAG スタッフロール•プラグイン」は 、 r ICAG 3¥ KAG 3 plugin ¥ staffroll ¥ sce - 
nario ¥ j の中にある 「 staffroll . ks 」 が本体です。まずはこれを自分のプロジェ 
クト.フォルダ下部の scenario フォルダにコビーしておきましよう。 


「 staffroll . ks 」 は 
2回以上呼び出さ 
ないでください。 
マクロの定義と同 
じで、〗回呼び出 
せば、それ以降機 
能が使用可能にな 
I ります。 


《シナリオの書き方》 

続いて、シナリオの書き方ですが、スタッフロール•プラグインを使いたい 
プロジヱクトの 「 first . ks 」 の先頭行に以下のように記述します。 

♦シナ U 才記述例 

@call storage^"staffroll.ks" 


スタッフ ロール 
にメッセーン•レ 
イヤーは使いませ 
ん。このためスタ 
ッ フロー ルを使う 
前にメツセーン • 
レイヤーを非表示 
にしておくとよい 
でしよう。 


勘のいい方は気づいたと思いますが、この榻能はサブルーチン形式で提供さ 
れています。 「 staffroll . ks 」 の中を開いてみると、いちばん最後の行に 
「@ retum 」 と書かれていることからも分かり苡す。このサブルーチンを呼び出 
すことで、以下の5つのスタッフロール用タグが使えるようになります。 


staffrollinit _ 

staffrolitext 

staffrollimage 

staffrollstart 

staffrolluninit 


スタッフロールを せ期化する 
文字を表示する 


画像を表示する 
スタッフロール ( 


:クロールを 開始する 


スタッフロールを終了する 
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9-2 


スタッフ□ールを作る 



•シナリオ例 


@staffr 〇丄 linit 

@font size=50 color=0xff 0000 

©staff roll text x=100 y=480 text=" すたつふ' 1 

@resetfont 

@staff roll text x=100 y=80 text= ' 'スタッフ 1 
@staff roll text x=100 y=40 text= n スタッフ 2" 

©staff roll text x=100 y=40 text 二"スタッフ 3" 

@staff roll text x=100 y=40 text 二"スタッフ 4" 

@staffr 〇丄 limage x=100 y=80 storage="ayari_32.png" 
@staffrollimage x=100 y=80 storage^"kiri_s32.png" 
©staffrollstart height=1500 time=20000 
@wait time=20000 
@staffrol 丄 uninit 


システム迄)文字表示©粟をたどる u > ,菜をは洗 < m ) 凾面⑽ヘルプ妙 


スタッフ1 
スタッフ2 
スタッフ3 
スタッフ4 



実行例 


r@staffrolltextJ 行と 「@ staffrollimage 」 行の 「 x 」 と | y 」 や 、 I © staffrol - 
lstartj 行の rheight 」 「 time 」 、「 @ waitj 行の「 time =20000 j の値をいろいろ 
と調整して、自分の作品に合ったスタッフロールを作ってみてください。 


ベ' ぐ . 、ふ'ぃ 


吉里吉里プラグ 
インと KAG プラグ 
インは別のもので 
す。吉里吉里ブラ 
グインは DLL 形式 
で提供され、吉里 
吉里そのものの機 
能を拡張しますが、 
KAG プラグインは 
シナリオの書き方 
によって実行でき 
る特別な機能を提 
供するシナリオフ 
アイルです。 

吉里吉里プラグ 
インは、吉里吉里 
フォルダ直下の 
plugin フォルダに、 
KAG プラグインは 
KAG 3 フォルダ直下 
の kag 3 plugin フオ 
ルダに入っていま 

I す。 J 
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9-3 


エンデイング • 


ストを作る 


見たエンディング名を白で表示し、まだ見 
示するようなエンデイング•リストを作るに 
ろで使ったシステム変数を用います。 


ていないエンディングを灰色で表 
は、クリッカブル • マップのとこ 


まず、シナリオ内のエンディング記述部分 
記述します。値は「1」を代入しておきます 

籲シナリオ例 

に、 [ eval ] タグでシステム変数を 

「一晚 中、守ってくれて、ありがとう。 明」 

: p] 

[wait time=2000] ¥ 


[scenechange storage^" 00 '■ j ¥ 


[eval exp="sf.aendl7 =1"]¥ 


[jump storage 二 "xmaseve_credit.ks" 

[s] 

target=*ending02] ¥ 


シナリオ例4行目の [ eval ] で指定されてい本 
あり、 aendl 7 というシステム変数を「1」 （ 
けば、エンディングを見たときにそれぞれの 
エンデイングは「0」のままなので、あとは、 
れのシステム変数をチヱックして [ if ] による条 


「 sf . aendl 7」 がシステム変数で 
ています。同様の記述をしてお 
|変数が「1」になり、見ていない 
エンディング•リストでそれぞ 
件分岐を書けば、完成です。 










9-3 エンディング、リストを作る 


^memories 

; [position layer=messageO color=0xFF0000 opacity=0 left=0 
top=0 width=640 height = 480 marginL = 3 5 marginT = 3 0 
marginR=35 marginB=25]¥ 

[position layer=messagel color=0xFF0000 opacity=0 left=0 
top = 0 width=640 height = 4 8 0 marginL = 35 marginT = 30 
marginR=35 marginB=25]¥ 

[playbgm storage 二 " piano"]¥ 

[scenechange storage 二 " title2"]¥ 

[layopt layer=messagel page=fore visible=false]¥ 

[layopt layer=messagel page 二 back visible=false]¥ 

[er]¥ 

[current layer=messageO]¥ 

[backtxtclear]¥ 

[layopt layer=messageO page 二 fore visible=false]¥ 

[delay speed=nowait]¥ 

[font color=0xFFFF00]¥ 

お客様とお連れ様のイブの思い出は以下の通りです。 

[locate x=80 y=30][font color=0x00FFFF]Alive Ending 
[locate x=380 y=30][font color=0xFF0000]Death Ending 


[font size=14 co 丄 or=0x6666fc>6]¥ 

[locate x=20 y=60] [ch text=" 永遠に . （最終話）"] 

[if exp="sf•aend01 = = l"][locate x = 20 y= 6 0] [font 

color = OxFFFFFF ] [ch text=" 永遠に . （最終話） 

"][font color=0x666666][r][endif]¥ 

[locate x=20 y=75] [ch text= "ホワイトイブ （最終話）"] 

[if exp="sf.aend02 ==1 "][locate x=2 0 y=7 5] [font 

color = OxFFFFFF ] [ ch t ext = "ホワイトイブ （最終話） 

"][font color=0x666666][r][endif]¥ 

[locate x=2 0 y=90] [ch text=" ここはどこ？ぼくは誰？（最終話）"] 
[if exp="s f.aendO 3 ==1"][locate x = 2 0 y=90] [font 

color = 0xFFFFFF ] [ch text = "ここはどこ？ぼくは誰？（最終話） 
"][font color=0x666666][r][endif] ¥ 

[locate x=20 y=105] [ch text= " 帰りたぃ故郷へ （第七話）"] 

[if exp="sf•aend04 = = l"][locate x = 2 0 y=105] [font 

color = OxFFFFFF ] [ch text=" 帰りたい故郷へ （弟七 S 舌） 

"][font color=0x666666][r][endif]¥ 

[locate x=2 0 y=120] [ch text= "ロザリオの少女 （第六話）"] 
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[if exp="sf•aend05==l"][loca 
color=OxFFFFFF] [ch text = "ロザ L 
"][font color=0x666666][r][endif ]、 
[locate x=20 y=135] [ch text=" 彼女 C 
[if exp="s f.aendO 6 ==1"][loca 

color = OxFFFFFF] [ch text = "彼女ぴ 
"][font color=0x666666][r][endif]^ 
[locate x=20 y=150] [ch text=" 一人 C 
[if exp="s f.aendO 7 =-1"][loca 

color = OxFFFFFF] [ch text 二"一人び 
"][font color=0x666666][r][endif ]、 
[locate x=20 y=165] [ch text = "虚ろな 
[if exp="s f.aendO 8 ==1"][loca 

color = OxFFFFFF] [ch text 二"虚ろ < 
"][font color=0x666666][r][endif ]、 
[locate x=20 y=180] [ch text = "そんな 
[if exp="sf.aendO9 ==1 "][loca 
color = OxFFFFFF] [ch text=" そん < 
”] [font color=0x666666][r][endif 
[locate x=20 y=195] [ch text = "亲斤しぃ 
[if exp="sf.aendlO==l"][loca 
color = OxFFFFFF] [ch text = "亲斤しし 
"][font color=0x666666][r][endif]^ 
[locate x=20 y=210] [ch text="B 民つて 
[if exp="sf.aendll==l"][loca 
color = OxFFFFFF ] [ch text=" 眠っ 1 
"][font color=0x666666][r][endif]^ 
[locate x=20 y=225] [ch text = "魔導卽 
[if exp="sf.aendl2==l"][loca 
color = OxFFFFFF] [ch text = " 魔導 g 
"][font color=0x666666][r][endif ]、 
[locate x=20 y=240] [ch text =" 白ぃ孩 
[if exp="sf.aendl3==l"][loca 
colors OxFFFFFF] [ch text 二"白い石 
"][font color=0x666666][r][endif]^ 
[locate x=2 0 y=255] [ch text = "冬嫌ぃ 
[if exp= n sf•aendl4==l"][loca 
color = 0xFFFFFF] [ch text= " 冬嫌し， 


e x = 20 

才の少女 


• e x = 20 


力は弱くても 
: e x = 20 
> 力は弱くて 


• e x = 2 0 


ものさ 

: e x = 2 0 

ものさ 


e x = 2 0 


いる君へ 
: e x = 2 0 

いる君へ 


e x = 2 〇 


e x = 2 0 


e x = 2 0 


y=12 0] [font 

(第六話） 

(第六話）"] 
y=13 5 ] [font 
(第六話） 

(第六話）"] 
y 二 15 0 ] [font 
も （第六話） 

(第六話）"] 
y=165][font 
(第六話） 

(第五話）"] 
y= 18 0 ] [font 
(第五話） 

(第四話）"] 
y=195][font 

(第四話） 

(第四話）"] 
y=2 10 ][font 
(第四話） 

(第四話）"] 
y=2 2 5 ] [font 
(第四話） 

(第四話）"] 
y = 2 4 0 ] [font 
(第四話） 

(第三話）"] 
y = 2 5 5 ] [font 
(第三話） 
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"][font color=0x666666][r][endif]¥ 

[locate x=20 y=270] [ch text =" 消えない傷很 （第三話 ）"] 

[if exp="sf.aendl5 = = l"][locate x = 2 0 y= 2 7 0] [font 

color=OxFFFFFF] [ch text =" 消えない傷痕 （第三話 ） "] [font 

color=0x666666][r][endif]¥ 

[locate x=20 y=285] [ch text = "あたしのヒー ロ - (弟二 g 舌 ）"] 

[if exp="sf.aendl6==l"][locate x=20 y=285][font 

color=OxFFFFFF] [ch text= " あたしのヒーロ — （第三話 ） ，，][font 

color=0x666666][r][endif]¥ 

[locate x=20 y=3 00] [ch text=" 守ってくれてありがとう（第二話 ）”] 
[if exp="s f.aendl7 = = l"][locate x = 2 0 y=3 0 0] [font 

color=OxFFFFFF] [ch text=" 守ってくれてありがとう（第二話 ） "][font 
color=0x666666][r][endif]¥ 

[locate x=20 y=315] [ch text= ”雪だるまになった朝 （第二話 ）"] 

[if exp="sf.aendl8 = = l"][locate x=2 0 y=315] [font 

color=OxFFFFFF] [ch text = "雪だるまになった朝 （第二話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x-20 y=330] [ch text=" 来年こそは （第一話 ） "] ¥ 

[if exp 二 "s f.aendl9 = = l"][locate x = 2 0 y=330] [font 

color=0xFFFFFF] [ch text= "来年こそは （第一話 ） M ] [font 

color=0x666666][r][endif]¥ 

[locate x=320 y=60] [ch text= n 贖罪 （最終話 ）"] 

[if exp="sf.dend01 = = l"][locate x = 32 0 y=60] [font 

color=0xFFFFFF] [ch text = "贖罪 （最終話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=75] [ch text =” 人喰いベッド （最終話 ）"] 

[if exp="sf.dend02==l H ][locate x=320 y=75][font 

color=0xFFFFFF] [ch text = "人喰いベッド （最終話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=90] [ch text = "死者が扉を叩く 時 （第五話 ）"] 

[if exp="sf.dend03 = = l"][locate x=32 0 y=90] [font 

color=0xFFFFFF] [ch text = 1 •死者が扉を叩く 時 （第五話 ）， 1 ] [font 

color=0x666666][r][endif]¥ 

[locate x=32 0 y=105] [ch text = "山羊の仮面の呪い （第五話 ）"] 

[if exp="sf.dend04 = = l"][locate x = 320 y=l0 5] [font 

color=0xFFFFFF] [ch text = "山羊の仮面の呪い （第五話 ） "][font 

color=0x666666][r][endif]¥ 

[locate x=320 y=120] [ch text =" 祭壇の上の君 （第四話 ）"] 


■ 
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の夜明け 

t e x = 3 2 0 


の井戸 

|te x = 320 


たも同じ 

x=320 


[if exp="sf.dend0 5 = = l"][locdte x=320 

color=OxFFFFFF] [ch text =" 祭壇の上君 
color=0x666666][r][endif]¥ 

[locate x=320 y=135] [ch text:" 偽り 
[if exp="sf.dend06==l"][loca 
color=OxFFFFFF] [ch text= " 偽りの夜日★け 
color=0x666666][r][endif]¥ 

[locate x=320 y=150] [ch text = n 死者 
[if exp="sf.dend07==l"][loca 
color=OxFFFFFF] [ch text 二 " 死者の井戸 ’ 
color=0x666666][r][endif]¥ 

[locate x=320 y=165] [ch text =" あな 
[if exp="sf.dend08==l"][loca 二 e 
color=OxFFFFFF] [ch text= ，，あなたも同!じ 
color=0x666666][r][endif]¥ 

[locate x=320 y=180] [ch text = "悪夢 
[if exp="sf.dend09==l"][locate 
color=OxFFFFFF] [ch text = "悪夢の続き 
color=0x666666][r][endif]¥ 

[locate x=320 y=195] [ch text=" あな ： t も才才カミ t こ 
[if exp= " sf . dendlO = = l"][locat:e 

color=OxFFFFFF] [ch text =" あなたも才 
color=0x666666][r][endif]¥ 

[locate x=32 0 y=210] [ch text= " 逃れ,ぬ運命 
[if exp="sf•dendll==l"][locate 
color=0xFFFFFF] [ch text = "逃れ得ぬ運命 
color=0x666666][r][endif]¥ 

[locate x=320 y=225] [ch text = "寒さ中中で 


め続き 


y=12 0 ] [font 
( 第四話 ）"] [font 

(第四話）"] 
y=13 5 ] [font 
( 第四話 ）"] [font 

( 第三話 ）"] 
y=l 5 0 ] [font 
( 第三話 ）"] [font 

( 第二話 ）"] 
y=165][font 
( 第二話 ）"] [font 


( 第二話 ）"] 
k=32 0 y- 180] [font 
( 第二話 ）"] [font 


：320 


N ■カミに 


x=320 


( 第二話 ）"] 
y 二 19 5] [font 
( 第二話 ）"] [font 

( 第二話 ）"] 
y=2 10 ][font 
( 第二話 ）"] [font 


:1 "][locati 


x=320 


[if exp= " sr . aendl^:== 
color=0xFFFFFF] [ch text 二 " 寒さの中で 
color=0x666666][r][endif]¥ 

[locate x=320 y=240] [ch text= " つし、 If きたもの 
[if exp="sf.dendl3==l"][locat 
color=0xFFFFFF] [ch text= " つし、てきたもの 
color = 0x666666][r][endif]¥ 

[locate x=320 y=255] [ch text 二 , ’ 痴言舌味嘩 
[if exp="sf.dendl4==l"][locat 
color=0xFFFFFF][ch text=" 痴話喧嘩 


( 第二話 ）"] 
x = 320 y=225] [font 

( 弟 — S 舌 ）"] [font 


b x=320 


( 第一話 ）"] 
y=240][font 
( 第一話 ） "][font 

( 序章 ）"] 
y=2 5 5] [font 
( 序章 ） "][font 
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函 


color=0x666666][r][endif]¥ 

[locate x=320 y=285] [ch text = "各種一発死 
[if exp="sf.dendl5 = = l"][locate x = 3 2 0 

color=OxFFFFFF] [ch text = "各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=300] [ch text =' •各種一発死 
[if exp="sf.dendl6 = = l"][locate x = 3 2 0 

color=OxFFFFFF] [ch text 二 " 各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=315][ch text-" 各種一発死 
[if exp="sf.dendl7 ==1 "][locate x=3 2 0 
color=0xFFFFFF] [ch text= M 各種一発死 
color=0x666666][r][endif]¥ 

[locate x=320 y=330] [ch text = "各種一発死 
[if exp="sf.dendl 8 ==1 "][locate x=3 2 0 

color=OxFFFFFF][ch text=" 各種一発死 
color=0x666666][r][endif]¥ 

[resetfont]¥ 

[locate x=44 0 y=4 0 0][link target^ * r mish_memories 

color=0xFF0000 ] メニュ ー l こ民る [endlink]¥ 

[backlay] ¥ 

[layopt layer 二 messageO page=back visible=true]¥ 

[scenechange4 storage 二 " title2"]¥ 

[current layer=messageO]¥ 


★finish memories 


( 第七話 ）"] 
y=2 8 5] [font 
( 第七話 ） "][font 

( 第六話 ）"] 
y=3 0 0 ] [font 
( 第六話 ）"] [font 

( 第五話 ）"] 
y=315][font 
( 第五話 ）"] [font 

( 第三話 ）"]¥ 
y=3 3 0 ] [font 
( 第三話 ) "][font 


[fadeoutbgm time=1000] ¥ 
[backtxtclear]¥ 

[scenechange storage:title2 " ]¥ 
[er]¥ 

[wb]¥ 

[jump target=*option2] 
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9-4 制限時間つき選択肢を作る 


籲シナリオ例 


[layopt layer=0 page 二 fore visible 二 true]¥ 

[image storage="limit01.png"layer=0 page=fore]¥ 
[nowait]¥ 

[history output=false]¥ 

[locate y=300]¥ 

[link target ミ * sOl] 選択肢 A [endlink] 

[link target=*s02] 選択肢 B [endlink] 

[endnowait]¥ 

[backlay]¥ 

[cancelskip]¥ 

[clickskip enabled 二 false]¥ 

[image storage="limit02.png" layer=0 page=back]¥ 
[trans rule="meter.png" time=10000 vague=10]¥ 

[wt ] ¥ 

[jump target=*timeout]¥ 


::.へ:.:::.::::::パ:::::;::^::-:.、公::月::::::.:::::::':'::.::. s ::::::: :: ::::.故 く:::::::':む.':， 

:廳薩I:さ 

実釀の シナリオには 
行番号はいりません0 

.. :. . 二.....'...：.ぐ:.'....:...:，...：.， 

:：：へ::'::：'：.:.:''、 


[stoptrans] ¥ 

[rreeimage layer=0]¥ 
[clickskip enabled 二 true]¥ 
[ct]¥ 

選択肢 A が選択されました。 [1] 


[stoptrans]¥ 

[treeimage 丄 ayer=0]¥ 
[clickskip enabled=true]¥ 
[ct]¥ 

選択肢 B が選択されました。 [1] 








*timeout 
[ct]¥ 

[freeimage layer=0]¥ 
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34 [clickskip enabled=true] ¥ 

35 [s] 


《1〜 2 行目》 

まずは前景レイヤー0のフォアグラウ^ドを可視状態にし、そこに 
「 limitOl . png 」 というメーター用画像ファイル： 

レイヤー〇に選択肢を表示します。 


《10-11行目》 

続いて 「 limit 02. png 」 という残時間の存在 
ヤー1の裏画面に読み込み、 「 meter.pngjj 
riimitOl.pngJ から 「 limit 02. png 」 へトランジ 
時間内に選択肢を選んだ場合はジャンプ先_ 
を用い、強制的にトランジシヨンを停止します 


しない画像ファイルを前景レイ 
というルール.ファイルで 
|>ョンを行なっています。 

ラベルで [ stoptrans ] というタグ 


選んだ のにメーター 
ります。 


これを行なわないと選択肢を 
フアイルが稼動し続け在ことになり、おかしなことにな 


《26、33行目》 

また、 [ freeimage ] というタグは、指定された 
に解放します。この場合はメーター関係の画像 
一0を空にしています。このように使い終えた 
くことで、余分なメモリを消費することもなく: 
用しようとした時に前のデータが残っているこ 


メーター • ファイルと同時に背景画像も表示する場合は、 メーター •ファイ 
ルを透明度情報を持つ画像で作らないといけません。 


アンチエイリアスが掛かっていないシンプノ 
合は、 [ image ] タグの key 属性を利用します。 

key 属性は、透明にしたい色を rkey = OxRR |( 
が透明になる効果を持ちます。 「 key = adapt 」 
ラインで最も多く使われている色ピクセルの色！ 


を表示し、続いてメッセージ 


前景レイヤー0の内容を強制的 
データをク リアして前景レイヤ 
らきちんと元の状態に戻してお 
なり、次に前景レイヤー0を利 
ともなくなります。 


な形状のメー ターを利用する場 

GGBB 」 で指定すると、その色 
と指定すると、画像の最上部の 
が自動的に抜き色となります。 




9-4 制限時間つき選択肢を作る 


•記述例___ 

[image storage="meter.png" layer=0 page=fore 

key=0x000000]¥ 

ただし、上の方法でアンチエイリアスが掛かっている画像の背景色を抜こう 
とすると縁が汚くなります。このような場合は、「吉里吉里2」に付属する画 
像フォーマット.コンバータを使うといいでしよう。 

画像フォーマット.コンバータは rkr 2_218 r 2¥ kirikiri 2¥ graphconvJ の中に 
入っている 「 krkrtpc . exe 」 です。 

まず、 Photoshop の PSD ファイルなどの透過背景を持つ画像を準備し、そ 
れを画像フォーマット.コンバータにドロップするだけで、 KAG の前景レイヤ 
一に読み込むことのできる画像が生成されます。 

通常利用する場合、「透過情報を持った画像の出力形式 ( F )」 の部分は 「 a 
チャンネル付 PNG (メイン+マスク）」で構いませんが、 CD での配布を前提 
としており、サイズは小さくなくてよいから展開速度を上げたいという場合は 
32 bitBMP (メイン+マスク）を選びましよう。 
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Flash * や Premiere * などのソフトが使えるノ 
メーションなどのムービーを入れたいと思う1 

、は、オープニングに動画やアニ 
?しょう。 

KAG では専用のタグが用意されており 、 M 
の Flash ファイルを再生することができます。 

PEG 形式のムービーと SWF 形式 

癱シナリオ例 


*start 

[video visible=true left=0 top=0 ^ 

[playvideo storage= " logo.mpg " ]¥ 

[playvideo storage="Love•swf"]¥ 

[wv] ¥ 

^idth=640 height=480]¥ 

「 krkr . eXe 」 と同じ場所に Flash ファイル名 
じ場所に 「 krflash . dll 」 プラグインを 、 MP 
「 krmovie . dll 」プラグインを置く必要がありミ 
どでプラグインをロー ドする必要があります。 

:再生するには 「 krkr . eXe 」 と同 
EG などの動画を再生するには 
ミす。また、 「 firstks 」 の冒頭な 

•記逋例 


[loadplugin moduie="krmovie.dll , 'j 、 
[loadplugin module="krflash.dll" ]\ 

L 








9-6 右クリック動作のカスタマイズ 



右ク U ック動作のカスタマイズ 


っメ 


「吉里吉里/ KAG 」 のデフォルトの機能では、マウスを右クリックした場合 
メッセージ•レイヤーが非表示になります。しかし、この右クリックで固定の 
サブルーチンを呼ぶ動作を定義することができます。 



画面例1 


これは KAG 3 のサンプルとして付属しているプラグインの 一つで ある 
r ¥ kag 3¥ kag 3 plugin ¥ sample¥j 内の 「 rclick — tjs . ks 」 と 「 rclick _ tjs _ testks 」 を 
使ってみた結果、市販のゲームのように、右クリックで表示されるメニューに 
おいてゲームの進行データをセーブしたりロー ドしたりできるようになった例 
です。 

やり方ですが、「 rclick _ tjs _ test . ks 」 内に記述されているサンプル.シナリオ 
の必要な部分を 「 first . ks 」 にコピーし、 「 rclick _ tjs . ks 」 ファイルを scenario フ 
ォルダにそのままコピーするだけです。 

「 rclick _ tjs _ test . ks 」 内に記述されていた 「 @call storage = M rclick _ tjs . ks M tar - 
get =* rclick 」 の部分で 「 rclick _ tjs . ks 」 という外部サブルーチン.ファイルを 
呼び出し、上のような右クリックメニューを実現しています。 


f . 承#辂磲禅 
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システム©文芊表示⑸菜软汉 




会陸高校 


禍 .，： W 1- 口'■鎌 f ' を祕 rr 

.:' . ，ど ' : 

釋黻 


W ； , ； V,, 

V 繁敏お彎なグみぎ^、冷^^^•，ダ 、 ： 3 Vft 、め 

4 :. 


ま ' 



J r 


画面例2 

サンプルの『紫月』に搭載されている右ク L ックによるマップ表示です。 

これも同様に、メインシナリオ側から「 @ callstorage = , f rclick . ks M target = 
★ rclick 」 という記述で 「 rclick . ks 」 という名前のサブルーチン • ファイルを呼 
び出しています。 


また、もっとも基本的な右クリック.メニューを作るための 「 rclick . ks 」 は 
KAG システム•リファレンス内に記述されているのでご覧ください。この場 
合、ラベルが r^sublj なので、 first . ks などのメインシナリオからは 「@call 
storage = ,, rclick . ks n target =* sublj というように記述して呼び出します。 
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9-7 zoom プラグインの利用 




KAG 


zoom ブ，グィ:/側用 

背景や前景に表示した画像を拡大したり縮小したりするには、「 zoom ブラ 
グイン」を使います。このプラグインは 「KAG3¥KAG3plugin¥zoom¥sce- 
nario¥j の中にある 「zoom.ks」 が本体です。まずは、これを自分のプロジェ 
クト.フォルダ 下部の scenario フォルダにコピーして おきましよう。 

続いて、シナリオの書き方ですが、 zoom プラグインを使いたいプロジェク 
卜の 「first.ks」 の先頭行に、以下のように記述します。 


•記述例 

@call storage="zoom.ks" 

これも前述の 「staffroll.ks」 と同様、サブルーチン形式で提供されており、こ 
のサブルーチンを呼び出すことで、以下の4つの zoom 用タグが定義されます。 




_0011 n base レイヤーの画像をズームする 

前景レイヤーの画像をズームする 
wbgzoom^S base レイヤーの画像のズーム終了を待つ 
wfsxoowi 前景レイヤーの画像のズーム終了を待つ 


I 

mam 

__ 


_シナリオ例 

[image storage:"testO 丄 •bmp” layer=base page=tore]¥ 

まずは背景をズームオフ。 [1] 

[image storage="black.bmp" layer=base page=fore]¥ 

[bgzoom storage="testOl.bmp" bgstorage="testOl.bmp" sl=0 
st = 0 sw=640 sh=480 dl = 320 dt=240 dw=0 dh=0 time=3 000 

sccel=0]¥ 

[wbgzoom]¥ 

今度は前景の立ち絵をズームイン。 [1] 

[laycount layers=l]¥ 

[fgzoom storage 二 " akira.png" layer=0 mode=transp sl=320 
st = 480 sw=0 sh=0 dl = 160 dt = 0 dw=320 dh=48 0 time=3 0 0 0 
sccel=0]¥ 


:譯馨::.ん:::::壤 

■ ■ S 議 

+ ■麵 

-： -■■:..ぐ..ノ ..： m 
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dw= 640 dh=960 time=1000 


[wfgzoom]¥ 

もっとズームイン。 [1] 

[fgzoom storage="akira.png"lay^r=0 mode=transp sl=160 
st=0 sw=320 sh=480 dl=0 dt 二 - 240 
sccel=0]¥ 

[wfgzoom]¥ 

もっともっとズームイン。 [1] 

L rgzoom storage^"akira.png" layer : 

2 4 0 sw=640 sh=9 6 0 dl = -320 dt 

time=1000 sccel=0]¥ 

[wfgzoom]¥ 

もっともっともっと大きくできるのですが、|この辺でやめておきます。 [1] 


:〇 mode=transp sl=0 st 二 - 
-7 20 dw=1280 dh=1920 


1 ぎ罜占罕 




議__ 



睡_ 

:ず:.眷 Aft ひふ、''義 

r 卜戀 

1 '' '.、ユ \、、 'こ ] 


t ずは背读をズームオフ。 

今度は沾故の立ち絵をズームイン。 

むっとズームイン。 

もっともっとズームイン,， 

もっともっともっと.人きくできるのですが、この辺 • 
やめておきます。，. 


画像の ズーム 









9-8 


雪 • 雨プラグインの利用 
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靄 • 雨プラグインの利用 


「KAG3」 には、前景などに雨や雪を降らせるプラグインが準備されていま 
す。これらのプラグインは rKAG3¥KAG3plugin¥j 内にある 「rain」 と 「snow」 
フォルダに格納されているので、利用する場合はこれらのプラグインを自分の 


プロジェクト*フォルダにコピーしておきます。 

各プラグインフォルダ内の image フォルダに含まれている画像は 「feimage」 
や 「image」「other」 などのフォルダへ、そして scenario フォルダ内に含まれ 
ている ks ファイルは scenario フオルダにコピーします。 


「staffroll」 プラグインや 「zoom」 プラグインと同様、まずはプロジェクトの 「first.ks」 
の先頭行にプラグ'インをロードするためのサフフレーチン呼び出しコマンドを記述します。 


籲記述例 _ 

^ @call storage="snow.ks" 

@cal 丄 storage:"rain. ks" _ 

雪と雨の両方のプラグインを使いたければ、上の記述例のように両方記述 
する必要があります。 

籲 シナ U 才例 __ 

| [image storage^"test02.bmp" layer=base page=fore]¥ 

では、雪を降らせます。 [1] 

@snowinit forevisible=true backvisible=fa 丄 se 
しばらく待っていると上のほうから雪が降ってくると思います。 [1] 

細かい調整は snow.ks を変更することで可能になります。 [1] 

では止めてみましょう。 [1] 

@snowunimt 
止みました。 [1] 

では、雨を降らせます。 [1] 

@raininit forevisible=true backvisible=false 
どうですか？ 雨が降っていますか？ [1] 

雨の振り方は rain, ks を調整することで変更が可能です。 [1] 

では止めてみましょう。 [1] 

@rainuninit 

止みました。 [1] _ _ 


画像のコピーを 
し忘れるとプラグ 
インは動作しませ 
ん。雪と雨のブラ 
グインについては 
必ずシナリオ•フ 
ァイルと画像ファ 
イルの両方をプロ 
ジェクト•フオル 
ダにコピーしまし 

レつ。 J 
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各種カスタマイズの方法や、バージョン情報ダイ 
ア〇グの作り方など、作品が完成に近づいた！3理 
解 して おきたし■能を中心に解説します。 
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uu _ スに向けて 


■ セーブ • データの ロー ド画面 


ここでは、一般のゲームなどでメ、 


し:'.':.:：.:1:: 

55，' ' 11 •。ィ， ン‘ ： 〆 ，へ メ)'■'七 1 4 

_ 纖 _, 

wmmm 

，故を！^ 

1 籠_ 




■"■■■I 


ロード」を選ぶと表示される 


専用のデータロー ド画面を作ってみます。利用するタグは選択肢を配置する時 
に使った [ link ] タグと、変数を表示する [ emb ] タグの2つです。 

♦シナリオ例 

[link exp= M kag.restoreBookMark(0)"]¥ 

[emb exp 二 " kag•getBookMarkPageName(0)"]¥ 

[endlink]¥ 

[ emb ] タグで 「 PageName ⑼」という菜のセーブ•タイトルを表示し、それ 
を [ link ] [ endlink ] でくくり、クリックされたら 「 BookMark ⑼」というセー 
ブ • データをロー ドするという意味です。 

KAG の菜データには「0」から「998」までの番号が与えられており、1番 
目の菜には「0」、 2 番目の菜には「1」、 3 番引は「2」、4番目は「3」という 
ように番号が振られています。このため上記の例は「1番目のセーブデータを 
読み込む」という意味になります。 


これを元にしてロー ド画面を作ると、以下のようになります。 






•シナリオ例 _ 

*dataload 

[ct]¥ 

[nowait] ¥ 

[locate x=40 y=20] 再開する琴を選んでください。 

[style align=center] ¥ 

[link exp="kag.restoreBookMark(0) 

exp="kag.getBookMarkPageName(0)"][endlink] 

[link exp>= 11 kag . restoreBookMark (1) 

exp="kag.getBookMarkPageName(1)"][endlink] 


[link 


][emb 


][emb 


exp="kag.restoreBookMark(2)"][emb 


exp=" kag. getBookMarkPageName (2 ) " ] [esndlmk] 

[link exp="kag.restoreBookMark(3) 


][emb 
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セーブ•データの口ー ド画面 


exp=" kag. getBookMarkPageName (J ) " ] [endlmk] 

[link exp 二 " kag•restoreBookMark(4)"][emb 

exp="kag. getBookMarkPageName (4) " ] [endlmk] 

[style align=default]¥ 

[locate x = 400 y = 3 60 ][link target = *menu] メニューに民る 
[endlink]¥ 

[endnowait]¥ 

[s] 


[ link ] タグで表示される矩形の色を変えたい場合は、以下のように記述します。 


[link exp="kag.restoreBookMark(0)" color=0xrf 0000 ]¥ 


この color 属性は [ link ] タグを使ったすべての選択肢に使えるので、工夫をす 
れば面白 t ゝ選択肢を作ることができるでしよう。 



(来設定) 


(来設定》 


《来設定> 


再開する菜は？ 


醒祿い彝％ 

宿直員？ 


《来設定》 


(来設定) 


(来設定} 


(来設定》 


(来設定》 


タイ fv ルへ戻る 
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マウス • カーソルのカスタマイズ 


また、形を変える場合は、 「PageBreak_a.png」 や 「LineBreak_a.png」 を書 
き直す必要があります。 

この2つのファイルは、 24X24 ドットの小さな画像が横に16個並べられた 
16コマのアニメーションになっているので、 24X24 のサイズの画像を16個作 
って、それを横に並べれば、オリジナルの記号が作れます。 

• LineBreak—a.png 例 


• PageBreak—a.png 例 


■ マウス • カーソルのカスタマイズ 


吉里吉里で制作した作品では、オリジナルのマウス • カーソルが使えます。 
オリジナルのカーソルには 「アニメーション •カーソル」 （. ani ) と「一般の力 
ーソル」 （.cur) の2種類が指定できます。 

まずは拡張子が 「cur」 か rani」 のファイルを作ります。 Windows の Cur¬ 
sors フォルダ内にたく さん入っているので、初めての人はこちらから適当なも 
のを選ぶとよいでしょう。自分で作りたい人は専用のソフトを使うか、インタ 
ーネットで配布されているフリーのマウスカーソル • エディタなどを手に入れ 
て、それで作ります。 

cur フアイルが手に入ったら、それを template フオルダ内の other フオルダ 
に コピーし ます。 

続いて、 fConfig.tjsJ の以下の部分を開きます。 


// ♦ マウスカーソル 

//マウスカーソルを指定します。マウスカーソルは cr で始まるマウスカ 
//ーソル定数 （ 吉里吉里 2 SDK Help 参照） か、マウスカーソルフ 
//ァイル名である必要があります。アニメーションマウスカーソルも指定 
//できます。 

//マウスカーソル定数を指定するときは、 cursor タグで指定するように 
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LMJ _ スに向けて 




_ _蠹參⑩ 


、 .ベ.:く ： iV ^ 



Sw^SS 

麟落^^^凝織^^ 

..... ':.(::m. 

....::、二 

八 ::: i 

HIM® 8 

: : IV . 

へ'' _ 
_____ 
__圓^ 

_____.. 

____酬 

I 

wmmsmm 


/ ..' 

____ 1 
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；cursorDraggable = crSizeAll；// 


// 先頭に & をつける必要はありません。マウスカーソルファイル名を指定 
// する場合は •••• （ダブルクオーテーシヨン）でく くってください。 

; cursorDefault = crArrow; // 通常+マウスカーソル 
; cursorPointed = crHandPoint ； / ノリンクなどをポイントしたとき 
; cursorWaitingClick = crArrow; // クリック待ちの時 
； cursorDraggable = crSizeAll ； // トッセージレイヤをドラッグ可 

能なとき 


下部の4行を見れば、吉里吉里で利用されているマウス•カーソルは4種類あ 
ることが分かりますが、通常時とクリック待ちのときに同じファイルが指定され 
ているので、実質的には3種類になります。なぜ通常時とクリック待ちのときに 
同じカーソルを指定しているのかというと、この2 つの 状態はお互いに小刻みに 
入れ替わることが多ぐ別のカーソルを指定するとチラチラしてしまうからです。 

この部分に、以下の記述例のようにオリジナルの カー ソル名を指定します。 
ファイル名は拡張子まで指定し、「””」（ダブル•クオー テーシ ョン）でくくっ 
ておくと、間違いがありません。 


; cursorDef ault = " origmalOl.cur "； 

// 通常のマウスカーソル 

;cursorPointed ="original02.cur "； 

//リンクなどをポイントしたとき 

;cursorWaitingClick ="originalOl.c 

ur"; // クリック待ちの時 

；cursorDraggable =original03.cur" ； 

// メッセージレイヤをドラ 


ッグ可能なとき 


これでオリジナルのカーソルが使えますが、これとは別にゲーム.シナリオ 
の中で一時的にカーソルを変更したい場合は [ cursor ] タグを用います。 

•タグ記述例 

[cursor derault="origmalOl.cur" pomted="original02 . cur" 
click="original01.cur" draggable="Driginal03.cur"]¥ 

[ cursor ] タグの属性は、それぞれが 「 Config . tjs 」 の4行部分に該当します。 
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ダイアログのカスタマイズ 


■ダイアログのカスタマイズ 


菜を挟んだり、たどったり、ゲームを終了したりするときに表示される「は 
い/いいえ」ダイアログもカスタマイズすることができます。 

まずは、基本となる、どのようなダイアログでも常に表示される文字部分を 
変更してみます。 

「 system フオルダ」内の 「 YesNoDialog . tjs 」 を開き、以下の部分を探します。 

• YesNoDialog_tjs 例 _ 

// Yes ボタン 

add(yesButton = new ButtonLayer (this , pnmaryLayer)); 

yesButton. caption = "( よし 、"，. 

yesButton.captionColor = clBtnText; 

yesButton.width = 70; 

yesButton.height = 25; 

yesButton.top = th + 3 5 ； 

yesButton.left = (w - (70*2 + 10) >>1 )； 

yesButton.visible = true; 

// No ボタン 

add(noButton = new ButtonLayer(this, primaryLayer)); 

noButton. caption = " し、し、 え"； 

noButton.captionColor = clBtnText; 

noButton.width = 70; 

noButton.height = 25; 

noButton.top = th + 35; 

noButton.left = ((w - (70*2 + 10)) >>1) + 70 + 10; 
noButton.visible = true ； 

ここに記述されている「はい」と「いいえ」がダイアログに表示される文字 
なので、自分の好きなように修正します。ダイアログで「確認」と表示されて 
いる部分は、 「 YesNoDialog . tjs 」 の最下部にあります。 


















メニューのカスタマイズ 


L 一のカスタマイズ 


メニュー. バーに表示されている「システム/菜をたどる/菜をはさむ/画 
面」のような親 メニュー、 そしてそれらをクリックすると表示される子 メニュ 
一については自由にカスタマイズできます。 

セーブロードを使わない作品の場合、『菜』関係のメニューは表示しておい 
ても邪魔なだけなので、 「 false 」 にしてメニュー•バーから消しておきましよ 
ぅ。 

また、会話がほとんど存在せず、パラメータのみで構成されている「育成シ 
ミュレーションゲーム」のような場合には、メッセージ履歴を表示させても仕 
方がないので、肖しておきます。 

選択肢のない短編の電子小説の場合なら、『次の選択肢/未読まで進む』と 
いうメニューは不要なので、?肖しましよう。 

これらは、次の 「 Confit . tjs 」 内の記述を変更することで実現できます。 


_Config_tjs 例 

//- メニューの設定 

tunction Menu 一 visible_conrig() 

{ 

// メニューの表不/非表不の設定 

// true を指定すると表示され、 false を指定すると非表示になります。 
// メニューに表示するメニュー項目名については Menus . t js を書き換 
// えてください。 

// ♦ メニューバーを表示するか 

// 非表示にすると当然どのメニュー項目にもアクセスできなくなります。 

,• menu .visible = true ； 

// ♦ 「システム〉メッセージを消す」 

//このメニュー項目を非表示にしてもマウスの右クリックでのメッセージ 
// の非表示は引き続き有効です。 

; rightClickMenuItem.visiDle = true ； 
t 背景だけを見せる必要がなければ false に。 

// ♦ 「システム > メッセージ履歴の表示」 

,• showHistoryMenuItem. visible = true ； 
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yu —スに向けて 


i 


<卜」 


t メッセージ履歴を使う必要がなければ fali 
// ♦ 「システム > 次の選択肢 / 未読まで I 
// 進む」 

; skipT 〇 NextStopMenuItem.visible = 
t 選択肢がない作品の場合は false に。 

// ♦ 「システム > 自動的に読み進む」 

,• autoM 〇 aeMenuItem. visible = true ； 

// ♦ 「システム > 自動的に読み進むウェ 
； autoModeWaitMenu.visiDle = true ； 

// ♦ 「システム > 前に戻る」 

； goBackMenuItem.visible = true ； 
t 選択肢がない作品の場合は false に。 

// ♦ 「システム > 最初に戻る」 

,• goToStartMemiltem. visible = true ; 
t 最初に戻る必要がなければ fa 1 se に。 

// ♦ 「文字表示」 

； characterMenu.visible = true ； 

// ♦ 「文字表示 > 表示速度 > ページ末申で一気に」 
// ユーザがこのメニュー項目をチェックする 
//1 タグが無視されるようになります。 

； chNonStopToPageBreakltem. visiDle 
// ♦ 「文字表示 > — 度読んだところは」 

; ch2ndSpeedMenu.visible = true ； 

// ♦ 「文字表示 > 一度読んだところは > 

; ch2ndNonStopToPageBreakItem. visibJLe 
// ♦ 「文字表示 > アンチエイリアス」 

； cnAntialiasMenuItem.visible = tru ^； 

// ♦ 「文字表示 > フォント」 

; chChangeFontMenuItem. visible = trilie; 
t フォントをユーザーに変更させたくなけれ 4 false に。 
// ♦ r 呆をたどる」 

； restoreMenu.visible = true ； 
t 菜を使わない作品の場合は false に。 

// ♦ 「呆をはさむ」 


e に 0 

_ む」または「次の選択肢まで 
true ； 


と、 


true ； 


ページ末まで一気に」 
true ； 




メニューのカスタマイズ 


； storeMenu.visible = true ； 
t 呆を使わない作品の場合は false に。 

// ♦ 「画面」 

； displayMenu.visible = true; 
t 画面の表示サイズを変更させたくなければ false に。 

// ♦ 「ヘルプ」 

； helpMenu.visible = true ； 
t ヘルプがない作品の場合は false に。 

// ♦ 「ヘルプ > 目次 • • •」 

;helplndexMenuItem.visible = false; 

// ♦ 「ヘルプ > このソフトについて•••」 

； heIpAboutMenuItem.visible = false; 

// ♦ 「デバッグ」 

； debugMenu.visible = true ； 

t リリース前に必ず false に戻しておく。 ___ 

「 ConfiUjs 」 を書き換えた場合は、「吉里吉里」を再起動しないと変更が適 
用されないので、注意してください。 

また、 system フォルダ内の 「 Menu . tjs 」 を直接書き換えることによってメ 
ニューに表示ざれている言葉を変更できます。 

たとえば'、 

menu.add(this.systemMenu = new KAGMenuItem(this , "ンスァ厶 

(&S)", 0, "• ，， false)); : __ 

の行の「システム」という部分を「環境設定」のように変更すれば、「吉里吉 
里」の メニューに 反映されます。 

メニュー.コマンドを直接メニュー•バーに表示したい場合は 、 r MainWin - 
dow . tjs 」 を書き換えなくても TJS スクリプトを書けば可能です。 「 first . ks 」 の 
先頭などに、以下のような記述をします。 








リリ_スに向けて 


_ 


春シナリオ例 













メニューのカスタマイズ 


KAG 


// ♦ 「ヘルプ〉このソフトについて」を選択したときにでる 
//ウィンドウの表示領域のサイズ 

// このメニューを選択すると about.ks がそのウィンドウ内で実行され 

// ます。 

；aboutWidth = 320; // 幅 
；aboutHeight = 200 ； // 局さ 


上の3つの部分の設定が終了したら、 「 about . ks 」 というファイルを作りま 
す。この raboutksj は通常のシナリオとほとんど一緒ですが、いくつか制限 
があります。 

• 効果音バッファは1つしか使えない 
• ムービーは 再生できない 
•メッセージ•レイヤーは 1 つし か使えない 
• メッセージ 履歴は表示できない 

上記の点を踏まえて、通常のシナリオを書くような感じで書きましょう。 

•シナリオ例 

★set 

[title name= " このソフトウェアについて "]¥ 

[image storage:"help.bmp" layer=base page=fore]¥ 

[position left = 0 top=0 width=320 height = 2 00 
color=0xffffff opacity=0 marginl=15 margint=15 marginr=15 
marginb=15]¥ 

[nowait]¥ 

[font size=18]¥ 

ソフト名 

なんとかかんとか 

制作者 

なんとかかんとか 



[style align=right] 
[link 


color=0xff0000 
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IMJ —スに向けて 




exp 二 " System.shellExecute( 'http://www.piass.com/kpc/')" 
hint 」 吉里吉里 / KAG の公式サボートサイト "] 吉里吉里/ KAG 推進委員会 
[endlink] 

[link target 二 * exit] このダイアログを閉じる [endlink] ¥ 

[endnowait] ¥ 

[s] ! 

*exit 

©close 

上記の [ link ] タグの例のように exp 属性で [ System . shellExecute 」 に URL を 
指定しておくと、リンクをクリックしたらブラウザを起動して指定のサイトに 
アクセスするようになります。 

この例は 「 aboutks 」 内だけでなく、 一般! のシナリオ内でも利用できるの 
で、クリックしたときに指定のホームページにアクセスさせたい場合は上記の 
ように書くとよいでしょう。ただし、ユーザ+の誰もがインターネットへ常時 
接続できる環境を持っているとは限らないのす、多用は禁物です。 








Releaser による実行フアイル化 


■ 


Releaser による実行ファイル化 


細かい部分を詰め終わり、プロジェクトが完成したら Releaser を用いてリリ 
ースします。「リリース」は、直訳すると『公開する/発売する』という意味 
ですが、『解放する/手放す』という意味もあります。 

KAG で制作したプロジェクトは、専用の「リリーサー」を使ってリリース 
します。この作業をすることによって、画像やサウンド、シナリオなどのファ 
イルがバラバラにフォルダの中に入っていた状態を、大きな 一つの ファイルに 
まとめることができます。 

この作業を行なうことで、市販のゲームのように、プログラムである実行ファ 
イルが1個、セーブ•データを保存するフォルダが1個、そしてドキュメントが 
1個という、非常にシンプルでカツコいい形態で配布することができるわけです。 


リリーサ ーを 起動したら、リリ ース したいプロジェクト. フォルダを 指定 
し、アイコンをオリジナルのものに変更すれば、必要最小限の設定は完了です。 
すべての設定が終わったら作成ボタンを押せば、 exe 形式にリリースされます。 


曹_越識 


r 出力形式 


r •鄉廊:ァ〜かげ砂 
riB 力：?ァイ_-1 


^ £>€形式輿行可能ファイル迄） 


;| 〇 ：¥ Documents and Sett ings¥ Ad min 炫 trator¥*r スクトッゴ mple.exe 


Wmmm 




フォルダ删こ庚る < i > 




丰令ンせル 


Releaser の設定 
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■配布における注意点 



圧縮ファイルにして配布するときは、リリイサーで生成した実行形式ファイ 
ルの他に readme . txt を書きましょう。 

このファイルは、作品の説明や利用条件、バージョンアップ情報などを記載した 
『わたしを読んでね』という名前のテキスト•ファイルのことで、パソコン通信 
上で MSDOS 時代のプログラムがやり取りされていたころから存在しています。 
readme ファイルは、以下の三種類の形式で作ることができます。 

• 純然たるテキスト.ファイル 

• html 形式 

• Windows のヘルプファイル形式 

Windows 標準のヘルプ.ファイル形式である 「 hip 」 形式は、作るにはコツ 
が必要ですし、一部利用しにくい点があるため、あまり使わないほうがよいで 
しょう。これが持つメリットの多くは馴染み深い html 形式が兼ね備えている 
ので html で作ったほうがよいかもしれません。 

ただし、 html にするほどの内容でなければテキスト形式をお勧めします。テ 
キスト形式の最大のメリットは、対応するテキスト.エディタやメモ帳が短時 
間で起動でき、すぐに内容を読むことができる点です。このように、ゲームの 
説明を簡単に行なう程度なら純粋なテキスト形式のほうがべターです。 

readme は「こう書かねばならない」というルールはありません。すでに配 
布されている作品などを参考にしながら、いちばん見やすいと思えるものを真 
似するとよいでしょう。 

こうして、実行ファイルと readme . txt が準備できたら、圧縮ユーティリティ 
を使って LZH 形式などの圧縮ファイルに圧縮します。 「 Config . tjs 」 内で指定 
した、ゲームの セーブ •データを保存するフォルダに ついては、 「吉里吉里2」 
では自動的に作成されるようになったので、同梱する必要はありません。 

ただし、 CD - ROM などの書き込み不可能なメディア上で実行ファイルを実 
行すると、 savedata フォルダが CD - ROM 上に 作成で きないため、 エラーに な 
ります。回避するには、インストーラを用いてハードディスクにインストール 
するか、実行ファイルを手動でハードディ^ク上にコピーしてもらうよう 
readme で説明をする必要があります。 
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ここではある程度 KAG を使ったことがあり、コン 
ピュータに関する知識はあるが TJS がどういうも 
のかを難ら P ： いという方を対象に、 KAG をサンプ 
ルにしながら TJS の解説をします。 









TJS とは 

1 OQI KAG と TjjS 

ほとんどの方は「吉里吉里」というと 「 KAG 」 を使っていると思います。 
KAG を使えば、 「 TJS 」 がどういうものであるかを知らなくても、吉里吉里上 
でプログラミングができます。そのため、 rTTSj がいったいどういうもので何 
をやっているかを知る機会は少ないかと思います。 


* スクリプト言語 
script language 
アプリケーシヨンの機 
能を補完する簡易言語。 
Perl などもこれに含ま 
れる。 


簡単に言うと、 TJS は、「吉里吉里が直接 f 里解できるスクリプト言語*」で 
す。逆に言えば、吉里吉里は TJS 以外の言語|を理解できません。 

でも、 「 KAG でもプログラミングできるよ？」「奉れ？ KAG で今まで書いていたの 
は吉里吉里用のスクリプトじやないの？」という I ：とになりますよね。違うんです。 


ここではっきりさせておきましょう。 _ 

• IKAG 」 は 「 KAG 用のシナリオ」を実行ずる。 

• 「吉里吉里」はその 「 KAG 」 を実行する。 

• 「 KAG 」 は 「 TJS 」 で書かれている。_| _ 

ということなのです。 



吉里吉里は KAG 用のシナリオ • ファイルを_接実行しているわけではないの 
です。 KAG は「吉里吉里をノベルアドベンチャーゲーム•エンジンとして動 
作させるためのスクリプト」という、ちよっ_ややこしい表現がされているの 
はこのためです。吉里吉里がノベルアドベン寸ャーゲーム.エンジンとして動 
作するためのロジックがすべて TJS で書かれてしるのです。 


KAG を読もう 


KAG を使っている皆さんは、 KAG の systenj フォルダを必ず一度は覗いたこ 
とがあるでしよう。さらに、一度はそのフォルダにある 「 Config . tjs 」 を編集した 


ことがあると思います。 
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rConfig . tjsJ の拡張子 ftjsj はいったい何杏表わしているのでしょうか。 








M KAG と TJsQQ ^ 


そうです。 「 TJS って何だろう」と思いつつ、必要に駆られていじっていた 
この 「 Config . tjs 」 …それこそがまさに 「 tjs スクリプト」なのです。 

他にも拡張子が rtjsj になっているファイルがいくつもあると思いますが、 
これらが全部 TJS スクリプト • ファイルです。 KAG がどのように動くべきかが 
すべて記述されたファイルたちなのです。 

TJS を学ぶ場合、いったいどこから入門したらよいか迷うと思います。入門 
の「門」はさまざまなところにあると思いますが、ここでは KAG を読み砕く 
ことによって TJS を学んでいくことにします。 

KAG は吉里吉里を使おうと思った方がほとんど経験されているでしょうし、 
KAG は吉里吉里/ TJS の最大のサンプルであります。学ぶにあたり、すぐ手元 
にあるこのスクリプトを活用しない手はないでしょう。 


TJS はどういう言 


TJS はスクリプト言語です。 KAG もスクリプト言語の一種ですが、それより 
は相当複雑な文法です。そのぶんできることも相当複雑になります。 

TJS を簡単に説明するために、よく 「 Java * と JavsScript * を足して3で割っ 
たもの」と表現しています。「二つのものを足しておきながら3で割っている 
というのはどういうことなんだ？」と思うでしようが、 Java 言語と JavaScript 
言語の両方の特徴を持っておきながら、それらよりは簡素化されているという 
意味です。どちらかというと JavaScript に似ています。 

特徴としては①「タイプ•ルーズ*」な言語であること、②オブジヱクト指 
向的手法をサボートすること、③ C 言語系の文法体系をもつということです。 

この系統の言語はいくつかあって 「 JavaScript 系」などと言われていますが、 


Web ブラウザで広く用いられている本家 「 JavaScript 」 別名 lECMAScript *」 


や、その互換スクリプトである Microsoft の 「 JScript」 、 Macromedia Flash の 


制御言語である 「 ActionScript 」 もこの系統の言語です。これらの言語を既に 
使ったことのある方ならば比較的簡単に TJS を使いこなせるようになるでしょ 
う。あるいは、 TJS をいきなり学びはじめるのはつらいという方は、これらの 
言語から先に学ぶのも手かと思います。 


* Java 

Sun Microsystems 社が 
開発したオブジェクト 
指向のインタープリタ 
言語。機器依存のないブ 
ログラム開発ができる。 

* Java Script 
Netscape Communications 
によって開発されたス 
クリプト言語。 Java と 
の互換はない。 

* タイプ. ルーズ 
型による拘束の甘い。 


ホ ECMA 

European 

Computer 

Manufacturers 

Association 

欧州電子計算機工業会 


TJS がどういうものかを知らない方は、 KAG の TJS スクリブト群をぜひ一度 
「流し読み」してください。いまは意味が分からなくても、難しそうに思えて 
も、大丈夫です。ただ、その雰囲気をつかむだけでいいのです。 
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TJS とは 


BB 

tjs を m 


TJS を学び始める __ 


を勉強するための準備をしましょう。 



■ 用意するもの 


と言っても、みなさんはすでに手元に吉里吉里と KAG をお持ちでしょう。 
「テキスト.エディタ」は TJS スクリプトを編集したりするのに必要ですが、 
これといって他に必要なものはありません。すべてのツールをフリーソフトで 
用意して、フリー(無料)でプログラミングを始めることだってできます。 


* スクリプト • エディタ 
script editor 


* コンソール 

console 


ておくと便利なこと 


吉里吉里には「スクリプト•エディタ」と「コンソール」というものがあり 
ます。 

「スクリプト • エディタ*」 は、吉里吉里の実行中に Shift + F 2 を押すとでて 
くる簡素なエディタで、ウィンドウの左下にある青い右向きの矢印をクリック 
すると、入力されたスクリプトを TJS スクリプトとして実行できるものです。 

「コンソール*」 は、吉里吉里の実行中に Shift + F 4 を押すと出てくるもので 
す。下の入力欄に TJS 式を入力するとすぐに結果を表示できます。また、いろ 
いろなデバッグ用メッセージを表示することのできる場所でもあります。 

また、吉里吉里の起動時に「フォルダ/アーカイブの選択」というウィンド 
ウが出ますが、ここで「選択しない」ボタンを押すと、スクリプトを何も読み 
込まない状態で吉里吉里を起動することができます。素の状態の吉里吉里で 
何かテストをしたい場合に便利です。 


実験用のフォルダを作ろう 


吉里吉里はプロジヱクト、つまり開発を行なう単位をフォルダ単位で管理 
しています。起動時に「スクリプト • ファイル」ではなく「フォルダ」を選択 
するのはそのためです。 

なので、空のフォルダを適当な名前で作りましょう。 「 krkr . eXe 」 のあるフ 
オルダ直下に作ると楽です。ここではこれを「実験用のフォルダ」と名付ける 
ことにします。 
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TJS において「式 J は基本であり、いちばん重 
要な要素です。まず、その「式』から、お話し 
しましよう。 















※筆者注 

「 TJS 式」といっても 
「折り畳み式」や「電動 
式」の意味の「式」で 
はなくて「数式」「方程 
式」に近い意味の、「計 
算の方法や関係を表わ 
したもの」という意味 
の「式」です。 


QQI TJS 式とは 

KAG を使ったことのある方なら、 「 TJS 式」というのを何度か聞いたことが 
あるでしょう。 emb タグや eval タグ、 if タグの exp 属性や cond 属性など 、 KAG 
はいくつかの場面で 「 TJS 式」を必要とします※。 

TJS 式は変数を使う際には避けて通れないものなので、変数を一度でも使っ 
たことのある方なら必ず TJS 式を使っていたことになります。すでに TJS の一 
端に触れて V ゝたわけですね。 

KAG の変数操作に用いるような TJS 式は、 TJS という言語全体から見れば 
ごく一部の機能を使ったにすぎません。もっと複雑なこともできます。でも、 
初歩から入るのですから、ここではまず簡単な式からお話しします。 KAG の 
変数操作に慣れた方はすでに知ってる内容かもしれません。 

「1+2は？」と聞かれれば「3」だと誰もが分かるでしょう。この「1+2」と 
いうのは私たちがよく使う数学の「式」です。この私たちの分かりやすい式と 
似たような方法で TJS も式を解釈することができます。 

実際に試してみましょう。 

コンソールを開いてみてください。 

吉里吉里を起動し、「フォルダ/アーカイブの選択」というウィンドウで「選択 
しない」をクリック、 Shift + F 4 を押します。 



コンソール画面 
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そこに、 

1+2 

と入力して Enter キーを押してください。 


すると、 コンソールに、 

ーコンソール—：1+2 = ( int ) 3 _ _ 

と表示されたと思います(ここには書きませんが、実際には行頭に現在時刻が 
表示されます)。これは、「あなたが今入力した1+2の結果は3です」という意 
味なのです。 

同じように、 

4/2 + 2*3 

と入力して Enter キーを押してみてください。 

コンソーノレ： 4/2+2*3 = ( real ) 8 

と表示され、結果が「8」であることが分かります (int や real については後で 
お話しします)。 

「/」(スラッシュ）は私たちが普段「+丄と書いている「除算」を表わす記 
号で、「*」（アスタリスク）は私たちが普段「 X 」と書いている「乗算」を表わ 
す記号です。私たちが乗算や除算を足し算より先に計算しなければならないの 
と同じように、 TJS も式を優先順位をつけて計算します。 


カッコや実数*も計算できます(以下に例を示します)。 


コンソール 

(1+2)*3 

二 ( int ) 9 

コンソール: 

4*2.5 = 

( real ) 10 


コンソールを 使うと、ちょっとした電卓としても使えますね。 


また、 KAG を使う方は、変数*に値を代入したいときに「=」を使って、 

f.flagl = 0 _ _ 

などとコンソールに入力すれば、その時点ですぐに変数に値を入れることがで 
きます。 

ここで使っている「=」 （イコール) は私たちが普段使っている「=の右側と左 
側が等しいことを示す」という意味ではありません。「=の左側に、右側の値 
を代入する」という意味になります。このように、私たちが普段使っているの 
とはちょっと違う意味で記号が解釈されるものもあります。 


TJS 式とは BUM 


* 実数 

誤差を含む数。小数点の 
ついた数。 


* 変数 

さまざまな値を一時的 
に入れておく メモリ領 
域0 
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まとまった機能を呼び 
出して使うもの。 


，196 


今はコンソールに直接式を入力して実行し、結果を確認しました。このよ 
うに式を実行することを、「評価する」ともいいます。 


式の役割 


TJS の式の役割を考えてみましょう。 TJS において「式」は非常に重要なも 
のです。ほとんどすべての動作は「式」によって記述されていると言っても過 
W ではありません。 

KAG の 「 Utils . tjs 」 にある 「 han 2 zen 」 という関数*(関数については後で説 
明します)にはどれぐらいの式が使われているかを示しましょう。 


kag3¥template¥system¥ Utils.tjs 

function han2zen (str) 

{ 

var res ； 

var i ； 

for ( i = 0 ; i<str. length；i + +) 

{ 

var num=#str fil ； 
if (num>=0x002Q && num< = 0x7e) 

res + = $( Oxff00+num-0x2 0 )； 
else res+ 二 str「i 1 ； 

} 

return res ； 


上記の下線のあるところがすベて式です。かなりの部分が「式」ですね。い 
かに式がスクリプトの大きな部分を占めているかが分かると思います。 


これは「式」に与えられた力が、単に数値を足したり引いたりするような、 
私たちが普段「演算」として考えているようなことだけではなく、もっと重 
な動作や意味をもつことができるからです。これも追々説明していくことにし 
ましよう。 
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式の使い方 


このような TJS の式がどのように構成されて、どのように使われるかを見て 
みましょう。 


項と演算子 


TJS におけるすべての式は、「項」または「項と演算子」で出来ています。 
これには例外はありません。 

今までに出てきた「+」「-」「*」「/」「=」「（）」「•」のような記号は、すべて 
「演算子*」と言います。演算子には、計算の方法を指定したり、操作を指定 
したりする機能があります。 

TJS には以下のようなたくさんの演算子があります。 

>>=>> >=> >=> <<=<= <-> << < ======> =!== I= ! 

&&= && &= & ||= || |= | … •+++=+-= -- -*= 

* /= / \= \ %= % -=-[]()〜•？：，#$ 
delete incontextof invalidate instanceof lsvalid 
_int if new_octet real string typeof 

それぞれ重要な意味をもっていますが、よく使うのはほんの一部です。 
簡単な演算子には以下のようなものがあります。先ほども使いましたね。 


演算子の例 


演算子 

意味 

+ 

足し算 

- 

引き算 

* 

かけ算 

/ 

わり算 

= 

代入（左側の変数に右側の値を入れる） 

0 

カツ コ(演算の優先順位を決める 


これらの中には場合 ( こよっては別の意味をもつものもありますが、追々説明しま' t 。 
また、もちろん他の演算子もたくさんあります>これらも追々説明しますし、[付録]の 
满算子一覧」や、「 TJS 2 リファレンス」などを適宜参照していただけると幸 t ゝです。 


演算子の両脇にあった「1」や「2」などの数字、あるいは 「 f 」 や 「 flagl 」 
などの演算子でない文字は、「項」と呼ばれます。計算や操作方法を指定する 
「演算子」に対して、計算や操作される対象の「値」を表わすものです。 


式の使い方 PE3 

拳#### 


* 演算子 

式の中で変数などに何 
らかの処理を行なう。 
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馨參 拳#拳參 


氺ステートメント 
statement 


式 


m 

_ 

「項」のみの「式」も TJS においては有効な「式」です。この場合は「演 
算子」がありませんから、演算などはされずに、その項の値そのものを表わす 


ことになります(難しく考えることはありません。単に「3」という項を書いた 
ら「3」という意味だということです)。 



式は以下の形式でよく使われます。 
式； 


式のあとに セミコロンを 書きます。これは「文」と呼ばれるもののうちの 一 
つです。私たちが日本語で文章を書くときに文末に「。」を書きますよね。そ 
れと同じように、 TJS では文の終わりには「;」 （セミコロン） を書きます。 

文はたくさん書かれた場合は、スクリプトの上から順に、書かれた順に実行 
されます。文は「ステートメント*」とも呼ばれます。 


式と結果 


式にセミコロンをつけたものが一つの文であるというお話をしました。「式 
にセミコロンつけて書いて、いったいどうするの？」と思うかもしれません。 
たしかに「1+1;」と書いたところで「1+1」が計算されますが、計算された結 
果はどこにいくんだろう、ということになります。 

結論から言うと、計算された結果は捨てられます。つまり、「1+1;」と書いて結 
果が「2」になろうと、その結果は捨てられる、つまりなんの効力ももたないのです。 

「結果が捨てられるんじゃ意味がないじゃないか」ということですが、必ず 
しもそうではありません。たとえば「=」演算子、これは単純な演算ではなく、 
「代入する」という立派な動作を伴います。 「 a = l ;」 と書くと、 「 a に1という 
値を入れる」という動作をした後、その式自体の結果が捨てられるのです。結 
局、この式を実行した後は、 「 a 」 には「1」が入っています。 

ただ、先ほど例に出した「1+1;」は本当に意味がありません。「1+1」は演算 
をして結果が出てくるだけでほかにはなんの動作も伴わず、さらにその結果が 
捨てられるのですから意味のない文なのです。実際は、 TJS はこういう文が書 
かれたとしても、まったく意味をなさないものとして実行すらしません。 

「=」演算子が変数に値を入れるように、演算の過程で伴う動作のことを、 
「副作用」と呼んでいます。 TJS における、式の後にセミコロンが付いた文は、 
副作用を起こすように記述するのです。 
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ここでは、昔からよく用いられる 「Hello world !"」 
を画面に表示するプログラムを書く」ことで 、 TJS 
でのプログラミングの一 S 蒲に触れたいと思います。 
いにしえの音から、プログラミング言語を学ぶとき 
には、画面に “Hello world !” と表示するプ□グ 
ラムを組むことになつているようです。私たちも C 
の通過儀礼に則ってみましょう。 







Hellow world 


______ 


画 

コン ソー j 


まずは、コンソールから 

ンソールに、以下のように入力してみましょう。 


J Hel 丄〇 world! 


* 文字列リテラル 
シングル/ダブル • クオ 
ーテシヨンで囲まれた 
文字の並び。 


すると、以下のように表示されるはずです。 

コンソール ： "Hello world!" = (Strina) "Hello world! M 


プログラミングをしたという気にはおよそなれないかもしれませんが 、 TJS 
が理解できる形で TJS に指示を与え、その結果 Hello world ! を表示できたとい 
う点においては立派な Hello world ! と言えます。また、コンソールの下の入力 
欄は正しい TJS 式のみを受け付けますので 、 "Hello world !” が TJS 式として正 
しいことが分かります(文字列リテラル*という項のみの式です)。 

それにしてもこれでは物足りないので、別の方法を試してみましょう。吉里 
吉里は画面に文字を表示する方法をいくつももっていますが、簡単な 「 Sys - 
tem . inform 」 というものを使ってみます。 


I スクリプト • エディタ」を表示させてください。 

吉里吉里を起動し、「フォルダ / アーカイブの選択」というウィンドウで「選 
択しない」をクリッ ク、 Shift+F2 を押す。 _ 

そこに以下のように入力してください。 

System.inform("Hello world ! M )； 


入力できたら、ウィンドウの左下の右向きの青い矢印をクリックしてくださ 
い（あるいは Ctrl + Enter でも t H 、です)。 

画面に 「 Helloworld !」 と書かれているウィンドウが表示されましたか？ 
「スクリプトで例外が発生しました」というメッセージが表示されてしまっ 
た人は、どこか入力したスクリプトに間違いがあったということです。よく見 
直してみてください。 
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3-1 まずは、コンソールから 


f^| 


參_ 



正しければこのように表示される 


首尾良く表示されたら、 "Hello world!” の文をいろいろ変えてもその通りに 
表示されることを確かめてみてください。 


一 System.infornu 丄 +2 ) ノ _| 

のように数式を入れると、その結果が表示されるのが分かると思います。この 
ように、 「System.inform」 は、その次に （） で囲まれた式を書くと、その内容 
を画面に表示することができるものだと言うことが分かると思います。 

1312 : x J 

令ぃ:. 


計算結果が表示される 

前の節で「式にセミコロンをつけたものは 一つの 文である」とお話ししまし 
た。 「System.inform(l+2);」 も文です。そして、 「System.inform」 は内容を画 
面に表示するという立派な副作用をもつ式です。 

そういえば、 「System.inform(l+2)」 が式ならば、「1+2」も式ですね。この 
ように他の式の中に書かれる式を、「部分式」と呼びます。 

「System.inform」 は、「〇」の中に書いた部分式の結果を表示するものと 
言うことができます。このように、式は文法が間違っていなければいくらでも 
複雑に書くことができます。 
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* プロジェクト 
ブログラムに必要な情 
報を集めたファイル。 


前に、「吉里吉里はプロジヱクト*をフォルダ単位で管理すると」述べまし 
た。吉里吉里は起動時にプロジヱクト • フォルダを指定されると、そのフォル 
ダの中にある 「 startup . tjs 」 というファイルを実行しようとします。そこで、 
この startup . tjs に "Hello world !” を表示するプログラムを書いてみましよう。 


実験用のプロジェクト • フォルダの中に 「 startup . tjs 」 というファイルを作 
ってください。それをテキスト•エディタで開いて、以下のように入力して保 
存します。 

System.inform("Hello world!"); 


はい、先ほどと同じです。 

そうしたら、吉里吉里を起動し、「フォルダ/アーカイブの選択」で、その 
実験用のプロジェクト • フォルダを指定しましよう。 

スクリプト•エディタから実行したのと同じように 、 "Hello world !” と表示 
されたと思います。 



賢 ：XI 

❹郡 

卜で例外雌生しま 
づ startup.tjs が見 

r 一… m .一 … I 

つかりません 


startup . tjs が作られていないと、エラー • メッセージが出る。 
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データの入れ物である数」は、プログラミング 
には欠かせないものです。 
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変数とは 




KAG でも「変数」という言葉は出てきました。ただ実は、「変数」だと KAG 
で説明してきた 「 f .」 や 「 sf .」 が頭につくものは、 TJS で言うところの「変数」 
とはちょっと違ったものなのです。これは「辞書配列」のところで再び説明し 
ます。 


TJS における「変数」とは、プログラマーとなるあなたが自由に名前を付け 
て、自由に値(数値や文字列などいろいろなもの)を入れておける場所です。変 
数を宣言するには、 fvarj を使います。 


さっそく使ってみましょう。前の章で説明した " Helloworld !” のプログラムを 
少し変えてみましょう。わざわざ 「 startup . tjs 」 に書き込んで実行するのは面 
倒なので、スクリプト•エディタで実験してみましょう。 

( startup . tjs に書いても、同様の結果が得られると思います)。 


* 編注 

実際のスクリプトには 
行番号は必要ありま 
ん〇 




var message ; 

message = " He 丄10 world ! 
System . inform ( message ); 


実行してみると、単に「 System.inform ("Hello world ! M ); J というプログラム 
を実行したのと同じ結果になると思います。 

齡:3 


Imormation 


令 


Hello MMorld! 


……诵 


1 


同じように 「Hello world !」 が表示される 


* 宣言 

どのような変数を使う 
かあらかじめ決定する 
こと。 


1行目で 「 message 」 という名前の変数を宣言*しています。 「 var 」 の使い 
方は次に述べます。 

2行目でその 「 message 」 という名前の変数に n Hello world ! 11 という値を入 
れています。「値」と聞くと「あれ？これは文字であって『値』ではないよ」 
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TJS 


4-1 変数とは 

______ ❿ 

と思うかもしれませんが、ここでは変数に入るものすべてを総称して「値」と 
呼んでいます。 

代入をするための演算子「=」は、 KAG で変数を使うときにも使いました。 

私たちが普段用いる「=」の意味とは違うので、注意が必要です。 

3行目では 「 System . inform 」 を使って 「 messsage 」 の中身を表示していま 
す。 「 message 」 の表わすものの内容が画面に表示されているはずです。 

また、プログラムが上から順に、書いた順に実行されているのが分かると思 
います。 
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var の使い方 


var キーワードは変数を「宣言」するために用います。 TJS では変数を使お 
うと思ったら、その変数を使うことを「宣言」しなくてはなりません。 


変数を宣言するには、 「 var 」 に続いて「スペース」を空け、変数名を書き、 
「;」（セミコロン）を書きます。 

上記の例では 「 varmessage ;」 と書くことで 「 message 」 という変数を宣言 
したことになります。 


_変数はカンマで区切っていくつでも宣言することができます。たとえば、 

_ var a, _b, _c;_ 

と書けば、 「 a 」 と 「 b 」 と 「 c 」 の3つの変数を宣言したことになります。 


もちろん、これは、 

var a ； 
varb ； 
var c ； 

とも書けます。 

変数名の後に「=」（イコール）を書いて、その後に「式」を書くと、その変 
数にあらかじめ、その「式」の表わした値(数値や文字列など、なんでも）を入 
れておくことができます。 

たとえば、上記の "Hello world !” のプログラムは、 
var message = "Hello world!"; 

System.inform(message); 


と書くことができます。 










4-3 変数の命名規則 | 
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変数の命名删 


KAG の変数と同じく、 TJS の変数にも、「使える名前」と「使えない名前」 
があります。これは頭に 「 f 」 や 「 sf .」 が付かないこと以外は KAG の変数のお 
約束とまったく同じなのですが、ここでおさらいすることにします。 


■変数名には半角英数と全角文字 、 rj (アンダー•バー）を使 
5ことができる 


「 abc & def 」 や 「 a - z 」 のような変数名は使えません。 


rfinal _ countJ のようにアンダー•バーを含んだり、主人公の名前のよう 
に全角文字を使うことができます(全角の記号はすべて使用可能です)。 


変数の名頭に半角の数字がくることはできない 


「2 friends 」 や 「3 size 」 のような変数名は使えません(全角の数字が先頭に 
くるのであれば 0 K です)。 


「予約語』は使えない 


以下の単語は「予約語」なので使えません。 

break continue const catch class case 
debugger default delete do extends export 
enum else function finally false for 
global getter goto incontextof invalidate 
instanceof isvalid import int in if 
null new octet protected property private 
public return real synchronized switch 
static setter string super typeof throw 
this rue try void var while with 


ただし、 「 count _ to _ skip 」 や 「 count _ true _ ends 」 のように、予約語*を「含 
む」ことはできます(予約語そのものの変数名は使えないというわけです)。 
上記の例では 「 message 」 という名前の変数を使っています。特に理由が 


* 予約語 

変数として自由に使え 
ない単語。 
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章 



% 

m 

______ ない限りは、分かりやすい名前を付けるべきです。筆者は、慣用的に以下の 

ような変数を使います。これらの変数名を使わなければならない理由はまった 
くないのですが、実際、 KAG の TJS スクリプトではこのような変数が多用され 
ているのでここで簡単に述べておきます。 


慣用的な変数の使い方 


変数名 
ijk 

意味 

よく for 文のカウンタ用の変数として使う。 

n 

よく整数を表わす。 

str 

よく文字列を表わす。 
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TJS におけるデータはすべて「型」をもっています。データの特性を決める 
重要な概念です。 



KAG の変数は数値でも文字列でも入れることができました。 TJS の変数も 
そうです。この「数値」や「文字列」というのが「データ型」、つまりそのデ 
一夕がどういう種類のものであるかということです。 


KAG で変数を操作する場合には、 TJS のもっているすべてのデータ型を使う 
ことはおそらくないでしょう。ただ、 TJS のデータ型は、「数値」や「文字列」 
だけではありません。これから TJS の扱うことのできるデータ型について説明 
します。 

本当は、ここで紹介する他に「オクテット列型」というのもありますが、こ 
こでは説明しません。 


整数型 


そのままズバリ、整数*を扱うことができる型です。 

扱える数には上限と下限があって、「上限」は約922京、「下限」は約マイ 
ナス922京です。日常的に使うほとんどの数値はこの範囲内に収まっているの 
で、とくに困ることはないと思います。 

コンソールでは、結果がこの型になったとき （int *) という表記をします。 

TJS スクリブト中にこの整数型の数値を書くときは、普通に数字を書けば 
「10進*整数」として扱われます。このように、スクリプト中に直接現われる 
数値や文字列そのものの項を、「即値」と呼んでいます。 

試しにコンソールの下の入力欄に「123」と入力して Enter キーを押してみ 
ましょう。 「( int )123」 と表示されたと思います。これは入力された数値が、 
「123」という「即値」で、「整数」として扱われていることを示します。 


デ - 夕型 BIHB 


* 整数 

0と自然数、逆自然数。小 
数点の無い数。 


* int 

inteaer 

整数 

*10 進 

「0」から「9」の数値を使 
つて、「0」から順にカウ 
ントし、「9」の次に、桁 
上げをして「10」と表現 
する。 
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*16 進 

16で桁上げをして「10」 
と表現する方法。一桁 
分で〇〜15までの数値 
を表すため、「0」から 
「9」まではそのままだが 
10以降は 「 A 」 から 「 F 」 
の文字を用いる。 

* 実数 

誤差を含む数。小数点の 
ついた数。 


変数 


即値を書くときに先頭に 「0 x 」 を付けると「16進*表記」の整数になりま 
す。たとえば 「 Oxff 」 と入力して Enter キーを押せば、 「( int )255」 と表示され 
るでしょう。これは「_が「255」という整数として扱われていることを示 
しています。 


実数型 


実数*を扱うことができる型です。小数点以下の値も扱えます。 

この実数型にも扱える数に上限と下限があって、「上限」は約 1.79 X 10 3 。 8 、 
「下限」は約- 1.79 X 10 3 。 8 です。精度は10進で約15桁あります。 

コンソールでは、結果がこの型になったとき 「( real )」 という表記をします。 


文字列型 


文字列を扱うことができる型です。 
文字列の長さに制限はありません。 


TJS スクリプト中に文字列を直接書くときは 「 n M (ダブル.クオーテーシヨ 
ン）または「"」（シングル•クオーテーシヨン）で囲まなければなりません。この 
ように、「””」や M で囲まれた、 TJS スクリプト中に直接書かれた文字列の 
即値を「文字列リテラル」と呼びます。この文字列リテラルは、さっそく 「 Hello 
world !」 にもありましたね。 KAG のソースにもところどころ出てきています。 


演算子である「+」（プラス）演算子は数値を加算する演算子なのですが、こ 
れが文字列を相手にして使われると、「2つの文字列を連結する」という意味 
になります。数値としての加算が行なわれるのは、+の両側が両方とも数値型 
(整数型か実数型)の場合だけです。どちらかが文字列、どちらかが数値だった 
場合は、数値は文字列に変換されてから連結されます。 

たとえば 、 Hello world ! を以下のように改造してみましょう。 
var message 1= "Hello ", message2 = "world!"; 

System.inform(messagel + message2 )； 

改造しないままのものと結果が同じになったと思います。 「 messagel 」 に入 
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っている” Hello ” という文字列と、 「 message 2」 に入っている 11 world !” の文字 
列を、「 messagel + message 2 j という式で連結して M Helloworld !" という文字 
歹 IJ にし、それを表示しています。 

コンソールでは、結果がこの型になったときには (string) と表記します。 


:クト型 


オブジェクト型は「オブジェクト*」を扱う型です。 


オブジェクトには「関数」「クラス」「辞書配列」「配列」「プロパティ•才 
ブジェクト」などなど、いくつか種類があります。オブジェクトについては、 
またあとで詳しく説明します。 

コンソールでは、結果がこの型になったとき 「( object )」 と表記します。 


void 型 


void * 型は「何も表わさない」ことを表わしています。 


void 型には何も入りません。 void 型は void 型であり、そして「何も表わさ 
ない」のです。 

しかし、何も表わさないといっても、何も表わさないなりに、数値としては 
「0」、文字列としては「空」文字列として扱われます。 

「 void 」 というキーワードがあって、これが常に void になります。コンソー 
ルから 「 void 」 と入力してみましよう。「コンソール ： void = ( void )」 と表示さ 
れたと思います。コンソールでは、結果がこの型になった場合、 「( void )」 と 
表記します。 

宣言したまま、何も値を入れていない変数は void 型になります。また、後 
で説明しますが、何も値を返さない関数は 「 void 」 という値を返していると見 
なされます。 


デ - 夕型 BIE1 


* オブジェクト 
object 


氺 void 
ヴオイド 
空虚 
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* タイプ. ルーズ 
type loose 


タイプ • ルーズ 


TJS は「タイプ•ルーズ*な言語」（データ型による拘束がアマく、ダラシな 
い言語）という類のものです。 


他のプログラミング言語と比較すると分かると思いますが、 C ++ や Java 、 
Pascal のような言語は、データ型に厳しい言語です。変数を宣言するときにそ 
の変数の「型」も一緒に宣言しなければならなく、その変数にはその宣言した 
型のデータしか入れることができません。これに対し、 TJS の場合は型を指定 
しません。その変数に入れたデータ型によって、その変数の型が決まります。 


C ++ や Java や Pascal では、たとえば文字列を整数に変換するのは、通常、そ 
の言語仕様としてはサポートされていません。 

TJS の場合は、たとえば整数が要求される場面で文字列を渡しても、自動的 
に文字列を整数に変換して処理します。文字列が要求される場面で実数を渡 
せば、実数が文字列に変換されて使われます。つまり、型変換を、ある程度 
自動的に行ないます。 

このように型に関してあまり厳しくないので「タイプ•ルーズ」と呼ばれて 
いるのです。型をあまり気にせずに気楽に使えるというメリットがあります 
が、型に起因するバグを見付けにくいというデメリットがあります。 
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関数とは 



* サブルーチン 
sub routine 

機能的にまとまった処 
理を行なうルーチン。 


「関数」というのは「何か機能をまとめて書いておいて、あとで呼び出して使 
うもの」です。 KAG にもサブルーチン*がありましたが、それと概念的には同じ 
です。もちろん TJS の「関数」は数学で使う意味のように「与えられた値に対す 
る数を示すもの」という意味でも使えますが、たいていは前述の用途でしょう。 



y % function intrandom(min = 0, max = 0) 


// min 以上 max 以下の整数の乱数を返す 

// 引数が一個だけの場合は〇〜その数までの整数を返す 

if (min>max; { min <>-> max ； } 

return int (Math. random () * (max-min+1)) + min ； 


関数をみてみる 


なにはともあれ、 KAG で定義されている関数を1つ見てみましょう。 
「 Utils . tjs 」 にある 「 intrandom 」 という関数です。 


先ほど「定義」と言いましたが、関数も変数と同じく、定義(宣言）しなけ 
れば使えません。定義にはこのように 「 function 」 を使います。 

「 function 」 に続く 「 intrandom 」 というのが「関数名」で、この名前の付 
け方には規則がありますが、変数のものとまったく同じです。 


* 引数 

プログラム • コー ドが 
関数やサブルーチンを 
呼び出すときに渡す値。 


関数名の次には （） で囲まれた部分があり、この中に「引数*」を書きます。 
引数とは関数に渡される値のことです。関数に渡した値は、ここに書いた変数 
に入った状態で受け取ることができます。「=0」と書いてあるのは、「関数を呼 
び出すときに、その引数が省略された場合は0になりますよ」という意味です。 


* 乱数 

でたらめな数値。 


そのあとの「{」と「}」で囲まれた部分が、関数の中身です。 

この関数の中身については今はまだ説明していないものが多いので詳しくは 
述べませんが、そこに書かれたとおり、「与えられた2つの引数のうち 、 min 
以上 max 以下の乱数を返す」という機能をもつ関数です。 

ただ、その中に 「 return 」 というのがあるのに注目してください。 return は 
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そのあとに書かれた式を関数の「結果」として返すためのものです。この値は 
「返値」や「戻り値」など、いくつか呼び方があります。関数が何か値を返さ 
なければならない場合、必ずこの return を使います。 


■ 関数を呼んでみる 


実際に関数を使ってみましょう。関数を使うことを「関数を呼ぶ」とも言います。 

KAG を起動してみてください。吉里吉里 SDK についてくる紹介用スクリブ 
卜でもけっこうです。そして Shift + F 4 でコンソールを表示してください。 

コンソールの下の入力欄に 「 intrandom ( l ， 3)」と入力して Enter キーを押し 
てみましょう。1以上3以下の乱数が表示されるはずです。 

このように、関数を呼び出すときは関数名の後に （） を書き、その中に引数 
となる式をカンマで区切って書きます。もし、その関数には引数の必要がない 
なら、 （） の中には何も書きません。 

関数名の後に （） を書くのは "Hello world !” でもすでにやりました。あれは 「 Sys - 
tem . inform 」 という関数を呼んでいたのです。引数は画面に表示するものでした。 

また、上に示した関数 「 intrandom 」 の中にも関数を呼んでいるところがあ 
ります。どこにあるか分かるでしようか。 

はい、「 Matii . randomO 」 ここです。「 Math . random 」 という関数を呼んでい 
るのです。この関数は0以上1未満の実数の乱数を返すという関数で、引数 
は無い ので （） の中には何も書かずに呼んでいます。 

「あれ、“ if ” や “ int ” というのもあるけど、これは関数を呼び出しているのでは 
ないの？」ということなのですが、 if は if 文という重要な文であって、関数呼び出し 
ではありません。 「 int *」 は演算子で、「右側に書かれたものを整数に変換する」と 
いう演算子です。右側の式が （） で囲まれているので関数の呼び出しに見えます 
が、この場合は （） は演算の優先順位を変えるためのものであって、関数の呼び 
出しではありません。 


酿とは 

壽#拳# _參_ 


integer 

整数 
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関数 

參 


関数の使い道 


KAG を使っている方なら、サブノトチンの利点は分かるはずです。何度も何度も 
同じような操作を行なう場合は、その一連の操作をサフフレーチンにしてしまえば、 
あとはそれを呼び出すだけです。同じことが、 TJS の関数にも言うことができます。 


たとえば、以下のような TJS スクリプトがあったとします。 
out_l_2 = (ill*ial*(br-1)*(ia2*br-l)+il2*ia2*br) / 
(ia2*br+ial*(br-1)*(ia2*br-l)); 

out—3—4 = (il3*ia3*(br-1)*(ia4*br-l)+il4*ia4*br)/ 
(ia4*br+ia3*(br-1)*(ia4*br-l)); 


なんだかグチャクチャしてて二度と書きたくないような式ですよね。もしこの計算 
を何回も繰り返すとき、その都度この式を書くと、プログラムが読みづらくなりま 
す。あとあと自分自身や他の人がプログラムを見たときに訳が分からなくなってし 
まわないように、プログラムはなるべく簡潔に綺麗に書くのがコッとされています。 

上の二つの式はよく見ると共通の構造をしていることが分かります。これを 
関数にして、上のプログラムを書き直してみると、下のようになります。 
function blend ( il—a, ia_a, il—b, ia_b, br) { 

return (il_a*ia_a* (br-1)* (ia_b*br-1)+il—b*ia—b*br) / 

(ia—b*br+ia_a* (br-1)* 
(ia_b*br-l ))； 


out_l_2 = Jolend(i 丄 1,ial,il2 , ia2 , br); 
out_3_4 = blend(il3, ia3, il4, ia4, br); 

計算を関数にまとめてしまったので、下の 2 行がすっきりとしていますね。 

このように「同じような操作を関数でまとめてしまう」ことによって、スク 
リブトをすっきりとさせることができます。また、関数に分かりやすい名前を 
付ければ、何をやっているのか一目で分かり、便利です。 

上で述べたように関数を自分で作って使う用途以外にも、どうしても関数 
を使わなければならない場面があります。それは、吉里吉里本体が提供してい 
る関数を使う場合です。 " Helioworld !” で使った 「 System . inform 」 もそうです。 
これはもともと関数の形でしか提供されていな t ゝのですから、関数として使わ 
ざるを得ません。 
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醜の作り方 



5-2 難の作り方 



関数を作ってみる 


簡単な関数を作ってみましょう。 

たとえば、引数を2つもち、その2つを加算した値を返すという簡単な関数 
を考えてみましょう。関数の名前は 「 add *」 という名前にします。 

関数を宣言するには 「 function 」 でしたね。スクリプト•エディタに、以下 
のようなプログラムを入力してみましょう。 
function add ( a , b ) { return a + b ； } 1 


氺 add 

加える 


function のあとにきているのは関数名、そして （） の中に引数です 。 「a + b 」 
を 「 return 」 で返しています。 

上記のスクリプトは一行で書かれていますが TJS ではこのように改行を書か 
ずにスクリブトを一行で書くことができます。これは次の章で詳しく説明しま 
すが、今は「こういう風にもかける」と考えてください。 

入力したら、左下の右向きの青い矢印をクリックです。クリックしても何も 
起こらないように見えるかもしれませんが、実際はこの関数は登録されたので 
す。確かめてみましよう。 


コンソールを表示させて、 「 add ( l ,2)」 と入力してみます。「3」と結果が出 
たでしょう。もちろん、 「 add (10, 50)」ならば「60」、 「 add (10,-10)」 ならば「0」に 
なります。関数 add の中では+演算子を使っているのですから、「 add (" hoge ”, 
M moge M )J * ならば n hogemoge n となるはずです。 


ホ hoge 

変数などの例としてプ 
ログラミングによく使 
われる。語源は諸説ある 
が、はっきりとしていな 
い。 
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「 return 文」は、 「 return 」 の次に式を書くことにより、その式の値を関数 
の結果として返すことができる文です。文ですので、最後に「;」 （セミコロン） 
を付けなければなりません。 


return の後の式は省略できます。省略された場合 、 「return void ;」 つまり 
「 void 」 を指定したのと同じ意味になり、 void が返されます。また、 return 文 
自体も省略できますが、その場合は関数の終わり、つまり終わりの n 」 の部 
分で呼び出し元に戻ることになります。この場合も void が返されると見なさ 
れます。 


return はその文が実行された時点で関数の呼び出し元に戻ります。関数の 
途中で、なにか条件によって呼び出し元に戻りたいときにも使えます。 

KAG の TJS スクリプト中の return 文を探してみて、その雰囲気をつかんで 
ください。 
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TJS がプログラムをどのように解釈するのか、ま 
た、人間にとって読みやすいプログラムを書くコツ 
を説明します。 










TJS は、「プログラム中の空白」「改行」「タブ」など、文字でないような要 


* ホワイト • スぺース 

white space 


素をすべて同じ「ホワイト.スペース*」というものとして見なします。連続 
したホワイト • スペースは 一つの ホワイト.スペースとして認識されます。 

また、意味が分からなくならなければ、ホワイト•スペースを入れなくても 
かまいません。逆に、意味が分からなくならないように適切にホワイト.スぺ 
ースを入れなければなりません。 


「ホワイト.スペース」とは、紙に印刷したときにその文字が印刷されず 


に、ホワイト（白い)スペース(空間)、つまり「空白」になる、そのような「文 
字でない要素」の総称です。ただし、全角スペースは TJS にはホワイト.スぺ 


ースとして認識されないので、注意してください。 


一前の章で出てきた以下の関数、____ 

—functionadd(a, d) { returna +_b ； } ___ 

を例に見てみましょう。 . 

「空白、改行、タブなどが『ホワイト.スペース』として認識される」とい 
うことは、つまり、たとえば空白を改行に置き換えてもよいわけです。上記の 
プログラムは以下のようにも書けます 0 _ 

function 

add(a , 
b) 

{ 

return a + 

b; } 


「連続したホワイト.スペースは一'つのホワイト • スペースとして認識される」と 
いうことは、改行の次に空白がきても、それは一つのホワイト • スペースであ 
るかのように扱われます。改行の個数や空白の数は問題ではありません。たと 
えば、上記のスクリプトを以下のようにも書くことができるということです。 
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function add ( a , b ) 

{ 


return a + b ; 

} 




スタイル 



讀_ _鬱# _ # 


「意味が分からなくならなければ、ホワイト•スペースを入れなくてもかま 
わない」ということに従えば、上記のスクリプトは以下のように書けます。 

function add ( a , b ) {return a + b ；} 


「意味が分からなくならないように、適切にホワイト.スペースを入れる」 

ということは、たとえば、もし上記のスクリプトのホワイト•スペースを全部 
取り去って、 

functionaad ( a , b ){ returna + b ;} 

と書いてはいけないということです。 「 functionadd 」 というのがありますが、 

これでは 「 function 」 と 「 add 」 ではなくて 「 functionadd 」 というつながった 
単語として TJS が認識してしまい、意味が分からなくなるのです。ですので、 

このような書き方はできません。 

* フリースタイル 

このように、 TJS はホワイト.スペースを自由に入れたり、あるいは入れな freesty，e 
かったりすることができます。このような言語のことを「フリースタイル*」 

の言語と呼んでいます。 

だからといって、やたら改行や空白を入れたり、空白を入れずに詰めて書い 
たりするのは良くありません。読みやすいように書くことが重要です。 


プロックのスタイル 


TJS のスクリプトをみると、よく { } で囲まれた部分を見掛けると思います。 {} で囲 
まれた部分は「ブロック」と呼ばれ、複数の文をまとめるために使われています。 

ブロックは文法上重要な意味を持ちますし、 {} は対応が見やすいようにし 
ておかなければ読みづらい プログラム になってしまいます。そのため、 {} 内は 
インデントを行なうのが一般的になっています。もちろんインデント*しなくて 
も プログラム としては動きますが、わざわざ見づらく書く必要はないはずです。 


* インデント 
indent 
字下げ 









文法とスタイル 


_ 


KAG の TJS スクリプトをみてもインデントされているのが分かると思います。 
たとえば、 「 Utils . tjs 」 にある 「 number _ format 」 という関数の中に以下のよう 

な部分があります。_ _ 

for(var i = 0; i <> n_len ； i++) 

{ 

var digit = n[i ]； 

’ if (digit >= '0，&& digit <>= 1 9 ') 

{ 

n_digits --; 
out += digit; 

if (n_digits > 0 && n—digits % 3 == 0) 
out ; 

} 

else 

{ 

out += digit; 


{ } の中がインデントされているのが分かりますね。 

{ } の書き方には大まかに2通りあって、上記のような書き方のほか、 
for(var i = 0; i <> n_len ； i++) { 
var digit = n[i ]； 

if (digit >= ' 0 ' && digit <>= ' 9 ' ) { 

n—digits 一一 ; 
out += digit; 

if(n_digits > 0 && n 一 digits % 3 == 0) 
out ; 

} else { 

out += digit; 


のような書き方もあります。 

筆者は前者を使っていますが、どちらでも意味は同じです。見やすい、ある 
いは書きやすいと思ったほうを使うといいでしよう。どちらにしろ、 { } 内は 
インデントされているというのが分かると思います。 







6-2 コメント 
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U メント 




プログラム 中に、 思いつい たこと や メモを書 t ゝて おきたいことがありますが、 
私たちが普段使うような日本語をいきなり スクリプト * の中に書くと文法 エラー 
になります。当然と言えば当然ですが、 TJS は日本語を理解できないのです。 


そこで、 「コメント」 というものを使います。 コメント * にすると 、 TJS は そ 
の部分をまるっきり無視するようになります。プログラ厶の一部分だけを実行 
したくないときにそこを コメントに してしまう、という用途にも使えます。 


TJS のコメントの書き方は2種類あって、17*」と「 V 」の間に書く方法と、 
行の「//」以降に書く方法です。 

たとえば、「関数」の章でも紹介した以下の関数には//形式のコメントが 
使われています。 

function intrandom (min = 0, max = 0) 

{ 

// min 以上 max 以下の整数の乱数を返す 

// 引数が一個だけの場合は〇〜その数までの整数を返す 

if imin>max) { min <>-> max ； } 

return int (Math. random() * (max-min+1))+ min ； 


// で始まっている行が 2 つありますよね。この行の、//から改行までの部 
分は TJS は無視します。プログラムの動作の解説を書いておくと後で見たとき 
の助けになります。 


もし、これを/**/形式のコメントにすると、以下のようになります。 


function intrandom(min = 0, max = 0) 

r 


i 

/* min 以上 max 以下の整数の乱数を返す 



引数が一個だけの場合は 

〇〜その数までの整数を返す */ 


IT (mm>max) { min <>-> 

max; } 


} 

return int (Math, random() 

* (max-mm+1)) 

+■ min; 


_______ 


* スクリプト 
script 


氺コメント 

comment 
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文法とスタイル 


m 
m 

_ 「//」のコメントと違って r /* v 」 は複数行を一気にコメントにできるの 

で、便利です。逆に、「//」は「/**/」と違ってタイピング量が少ないので、 
ちょっとしたコメントに便利です。 




if 文は「もし Q © ならば xx する」という、非常に 
よく使う重要な文です。 





KAG にも 「if タグ」というのがありましたが、 TJS にも 「if 文」というのが 
あります。条件によって実行するもの、あるいは実行しないものを記述すると 
きに使います。プログラム中では非常によく使うものです。これがないと単に 
並べられた文を実行することしかできませんが、 if 文があることで「もし〇〇 
ならばXXする」といった臨機応変なプログラムを書くことができるのです。 
KAG の TJS スクリプトを眺めてみても、 if を非常によく見掛けると思います。 


例として、「関数」のところで紹介した関数を再掲しましよう。 
function intrandom (min = 0, max = 0) 

{ 

IT (min>max) { min <-> max; } 

return int (Math. random () * (max-min+1))+ min ； 


if 文は上記の rif(min>max) {min<->max;}J の部分です。意味は 「min」 が 
「max」 よりも大きければ、 「min」 と 「max」 を入れ替えるという意味です （ 
<-> という演算子は、両側の変数の値を入れ替えるという意味です)。 


if 文はこのように （） の中に条件を書き、その次にブロックや文を書きます。 
条件が“真”のときのみ、ブロックや文を実行するという意味になります。 

ブロックは前の章でも少し紹介しましたが、詳しくは紹介していませんでし 
たね。また、条件式についてもこの章で説明したいと思います。 



ブロックは { } で囲まれたものです。 TJS ではこの中に文をいくつも書くこ 
とができます。このようなブロックを、「複合文」と呼ぶこともあります。 


if 文では、 if 文の次にブロックを書いて、その中に「条件が“真”のときに 
実行する文」をいくつも書くことができます。ブロックの中に書かれた文は、 
ブロックの外に書かれた文と同じように、上から順に実行されます。 
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7-1 臨機応変なブログラム 


上記の例では、 __ 

一 iT(min>max) { min <-> max; } _ 

でしたね。これはブロックの中に一つしか文が入っていません。 

これでも間違いではありませんが、実行する文が一つだけの場合は、 

IT(min>max) mm <-> max； _ 

と書いても同じ意味になります。 

「文の最後には「;」（セミコロン）をつける」と前に言いましたが、ブロッ 
クの後の場合にはセミコロンは要りません。 

ブロックの中に複数の文が入っている例を見てみましよう。たとえば、 「 Mes - 
sageLayer . tjs 」 にある 「 processLink 」 という関数では、 
if (In. storage ! = 1 ' || In. target !='') 

{ 

window.lockMessageLayerSelProcess(); // 選択を口 ック 
if(System.getKeyState(VK—RETURN) || 

System.getKeyState(VK_SPACE)) 
window.nideMouseCursor()； 

// キーボー ドによる操作の場合はマウス カーソルを 隠す 
window.process^ 丄 n• storage,In. target ,ln. countPage)； 


という if 文が使われています。 

if 文の次の中に複数の文が入っています。ここのブロックの中身は、 「 In . stor - 
age != M || ln.target != , f J という条件が“真”にならないと実行されないもので 
す。 


ちなみに、この章のタイトルが 「 if 文」となっていることでお分かりのよう 
に、 if も文です。普通の「式;」形式の文と同じように、 if も文としてブロック 
の中に書けます。上記の例でも if 文の次のブロックの中に if 文が入っているの 
が分かると思います。 

また、ブロックは、 TJS において重要な概念である「スコープ」というもの 
を決めるためのものでもあります。これは次章で説明します。 





「もし 〇〇 ならば XX する」というののついでに、「さもなければ△△する」 
というのを書きたい場合があります。このときに使うのが 「 else 」 です。 

「 else 」 は 「 if 」 に続いて書きます。 

例を見てみましょう。 「 Utils . tjs 」 の 「 han 2 zen 」 という関数には以下のよう 
な if 文があります。 

if (num>=0x002 0 && num< = 0x7e) 

res+=$(Oxff00+num-0x20); // UNICODE 
else res+=str[i]; 


これは、 「 num >=0 x 0020&& num <=0 x 7 e 」 、つまり 「 num 」 が 0 x 20 以上 0 x 7 e 
以下の場合に 「 res +=$(0 x £ f 00+ num -0 x 20);」 を実行し、そうでなかった場合は 
「 res += str [ i ];」 を実行します。 

ほかにも 「 else 」 はよく使われていますから、見てみてください。 


else 


「もし〇〇ならば xx する、さもなくてもし△△ならば□□する、さもな 
くてもし▽▽なら…」のように、違う条件でいろいろなものを実行したい場 
合です。 


例はいろいろなところにありますが、「 Utils . tjs 」 の「 kansuuji _ simple 」 を見 
てみましよう。 


if (digit ニニ " 

.") 


out += 

point ； 


else if (digit = 

="-") 


out += 

minus; 


else if (digit >= ' 0 ' ScSc digit く = 

' 9 ' ) 

out + 二 

digits [ +digit] ; 


else 



out + = 

digit ; 
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これは 、「 digit == ,f . M J ならば rout += point ;」 を 、「 digit == njl 」 ならば rout 
+= minus 」 を 、「 digit >= W && digit <= ! 9 f J ならば rout += digits [+ digit ] 」を、 
最終的にこれらのどれにも合致しなければ rout += digit .] を実行するという意 
味です。 


演算子 


いままで説明したのは、「文」としての if ですが、「演算子」としての if もあ 


ります。 


if 演算子は、 「 AifB 」 と書いた場合、 「 B 」 が“真”の時のみ 「 A 」 を評価(実 
行)する演算子です。英語の if に近 t ゝ構文で if を使うことができます。 

KAG の TJS スクリプトにも、たとえば、 

absolute = +elm. index if elm. index ! == void ； 

のような形で出てきます。この場合は、 「 elm.index !=== void 」 の場合のみ 
fabsolute = + elm . index 」 を実行するという意味になります。 
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B3 

if 文の次の 


条件式に使う演算子 


() の中には「条件式」というのを入れます。条件式も式の一種 
ですが、とくに値と値の関係を調べ、結果が“真”あるいは“偽”になるも 
のをいいます。 


* 演算子 

式の中で変数などにな 
んらかの処理を行なう。 


以下、条件式に使う演算子*を種類別に見て t 、きましよう。 


同定演算子 


「同定演算子」は、値が同じか同じでないかを調べる演算子です。 


以下にこの類の演算子を示します。 


演算子 

使い方 

意味 

== 

a == b 

a と b が同じ場合に真。 

!= 

a != b 

a と b が同じでない場合に真。 

_ 1 

a === b 

a と b が型が同じで、さらに値も同じ場合に真。 

| == 

a !== b 

a と b の型が違うか、あるいは値が違う場合に真。 


「==」演算子と「===」演算子、あるいは「!=」演算子と「!==」演算子の 
違いは、「型の一致」まで調べるかどうかです。 

たとえば、 r == J 演算子は「〃4"==4」のように文字列と数値を比較しても、 
その値が同じなので“真”になりますが、「”4" ===4」とすると、片方は文字 
列、片方は整数で、型が一致しないため、“偽”になります。「===」演算子や 
「!==」演算子はよく 「 void 」 との比較で使われますが、通常は「==」演算子 
のほうを使います。 


■ 比較演算子 


比較演算子は、値の大小の関係を調べるものです。 


演算子 

使い方 

意味 

< 

a < b 

a が b より小さい場合に真。 

> 

a > b 

a が b より大きい場合に真。 

<= 

a <= b 

a が b と同じか、あるいは a が b より小さい場合に真。 

>= 

a >= b 

a が b と同じか、あるいは a が b より大きい場合に真。 
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条件式に使う演算子 





二つの値が両方とも文字列型だった場合は 、 Unicode * における文字コード 
順での比較になります。 


論理 AND / OR 演算子 


「論理」とはこの場合は「“真”あるいは“偽”を扱う」という意味です。 
AND は「かつ」、 OR は「または」という意味です。 


演算子 

使い方 

意味 

&& 

a&&b 

3 . かつ b の場合に真。 

II 

a lib 

a または b の場合に真。 


ホ Unicode 

ISO で定められた文字 
コー ド体系。 一つの 体 
系で多言語文字を扱う 
ことができる。日本語 
版 Windows などで通常 
用いられている Shift 
JIS とは異なる。 


この演算子は両側に条件式を書いて使います。たとえば a が b と同じで、か 
つ、 c が d と同じである場合に“真”にしたい場合には、 


a 


k) ScSc c 


d 


と記述します。 


b || c == d 


ならば、 a が b と同じか、あるいは c が d と同じ場合に、“真”になります。 


前に例としてあげた 「 MessageLayer . tjs 」 にある 「 processLink 」 の if 文にも 
「 ln.storage != " 11 ln.target != ’’」というのがありましたが、これは「 ln . storage 」 
が「"」でない場合、または 「 ln . target 」 が「"」でない場合、という意味にな 
ります。 


■ 否定演算子 


「否定演算子」は、右側に書かれた条件式を「否定」する演算子です。否 
定とはどういうことかというと、“偽”ならば“真”、“真”ならば“偽”とい 
うように、真偽を逆にするということです。 


::積！！字:：::: 

使い方 

意味 

! 

!a 

a を否定 


「!」演算子の優先順位はかなり高くて、たとえば 「 a == b 」 という条件を否 
定したくて 「! a == b 」 と書いても正常に動いてくれません。これは 「(! a )== b 」 
と同じ意味で、 a を否定したものが b と同じかどうかを調べてしまいます。正 
しくは 「!( a == b )」 と書く必要があります。優先順序で分からなくなったら、 
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if 文 


カツコを使ってしまえば OK です。優先順序について詳しくは付録の「演算子 
一覧」 をご覧ください。 


条件式と真偽 


if 文は、条件式が“真”を示したときに、後続の文やブロックを実行すると 
いう文でした。“偽”の場合にはまるっきり文やブロックを無視します。 

では、“真”と“偽”はどのように TJS で扱われているのでしょうか。上で 
述べた演算子の説明でも「真になる」や「真偽を逆にする」という表現を使 
いました。 

TJS は“真”と“偽”を以下のルールに従って使います。 


•条件演算子を使う演算子は“真”のとき「1」、“偽”のとき「0」になる。 
•数値としての「0」以外が“真”、「〇」が“偽”。 


真偽を表わす演算子は“真”の時に「1」になります。試しにコンソールか 
ら「5==5」と入力して enter キーを押してみましょう。「1」と表示されまし 
たね。「5 ==5」は明らかに“真”ですが、それが「1」という結果になったと 
いうことです。「5==4」の場合は「0」、つまり“偽”になったと思います。 

数値としての「0」以外が“真”で、「〇」が“偽”とはどういうことでしょう。 

真偽を逆にする！演算子で試して見ましょう。コンソールに「!!0」と入力し 
てみます。 

「!!」と、！演算子を2回使っているので、否定の否定、つまり逆の逆で真 
偽はそのまま、という意味になります。「じゃあ、意味ないじゃないか」と思 
うかもしれませんが、いったん TJS に真偽の解釈をさせるためにわざとこのよ 
うに書くことにします。 

「!!0」の場合、「0」は“偽”なので、結果は「0」、つまり“偽”になった 
と思います。では「!!1」と入力してみましょう。「1」は「0」以外の数値、つ 
まり真なので、結果は「1」になります。「!6」ではどうでしょうか。「6」は 
「0」ではないので結果は「1」、つまり“真”になります。 



7-2 条件式に使う演算子 


TJS 


「0」以外の数値ならば「1」でも「2」でも「1000」もなんでも、“真”な 
のです。そのため、たとえば 「 if ( a ) b ;」 と書けば、 「 a 」 が「0」以外のときに 
「 b 」 を実行する、という意味の if 文になります。 

常に“真”を表わす 「 true 」 というもの、常に“偽”を表わす 「 false 」 と 
いうのがあって、真偽を表わす場合に「1」や「0」などと書くよりは分かりや 
すく書くことができます。 

ただし、真偽同士を比較してはいけません。たとえば A が“真”かどうかを 
調べるために 「 if ( A == true )」 と書いてはいけません。“真”は0以外の数値で 
あるとお話ししましたが、「4」でも“真”であるし、「-1」でも“真”、「5」で 
も“真”だからです。 「 true 」 は常に数値としては「1」なのですが、もし 「 A 」 
が「5」だったら、「5==1」の結果は“偽”になってしまいます。 A が“真” 
かどうかを調べたかったら、 「 if ( A )」 と書いてください。 
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変数の スコープ 



「これはよく使うから目立つところにおいておこう」とか、「これは邪魔だ 
から使うまではしまっておこう」など、私たちの日常でも、なにか物を置く場 
所は一考するところです。 


TJS の変数などにも同じことが言えて、置く場所を適切にすればプログラム 
が読みやすくなったり、実行速度が増したり、コードの保守性が高くなります。 


* グローバル 
global 


* 口ーカル 
local 


変数を置く場所には大まかに2つあって、ひとつは「グローバルな位置」、 
もうひとつは「ローカルな位置」です。 

「グローバル*」は「広域な」という意味ですが、そのとおり、グローバル 
な位置に置かれた変数はその「見える範囲」、つまりスコープが広く、どこか 
らも見えるようになります。 

それに対し、「ローカル*」は「局所的な」という意味であり、そのスコープ 
は限られます。 


ではどのように書くとグローバルな位置になり、どのように書くとローカル 
な位置になるのでしょうか。 

カギは { }、つまり「ブロック」にあります。 


ローカル 変数 


ブロックは前の章で複数の文をまとめる「複合文」の機能をお話しました 
が、実は単に複合文を作るだけではありません。スコープを作る、つまり見え 
る範囲を限定するという重要な機能があります。 


例を見てみましょう。 「 Utils . tjs 」 にある 「 han 2 zen 」 という関数は以下のよ 
うになっています〇 _ 

function han 2 zen ( str ) 

{ 

var res; 

vari ; 

for ( i = 0 ； iostr .length ； i + +) 
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8-1 変数の スコープ 

»# 拳#### 

varnum=#str[i] ; 
if (num>=0x002 0 && numo=0x7e) 

res+=$(0xff00+num-0x20); 
else res+=str [ i ]； 

} 

return res ； 


ブロックが二つあり、しかも片方はもう片方の中に入っています。その中で 
変数が宣言されています。 



の変数のスコープを図示すると以下のようになります。 


function hanzzen (str) 

{ 

var res; 
var i; 

for (i=0;i く str.length:i++) 

{ 

- 圈 m var num=#str [I] : 

if (num>=0x0020 && num<=0x7e) 
res+=$ (0xff00+num-0x20): 
else res+=str [i]; 

l 1 

return res; 

} 


変数 res について見てみましょう。 

「 res 」 は外側のブロックの最初で宣言されています。 res * が見える範囲、 
つまり res のスコープはここで始まっています。そして、ブロックが終わる場 
所、この関数の最後で res のスコープが終わっています。 

試しに KAG を起動し(起動すると、この han 2 zen という関数はすでに定義さ 
れた状態になっています)、コンソールから res と入力してみましよう。「メン 
”' n res n が見つかりません」といわれると思います。つまり、このブロックの 
外側では res は見えな I ゝのです。 




fres 


n 


氺 res 
response 


ところで、上の図には変数 str というのがあります。 str は関数の引数です 
が、これも実は ローカル 変数なのです。この変数の スコープは 関数の始まりか 
ら終わりまでです。 
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_ 參 # 4 聲 ■ 


* num 
number 


スコープ 

_ 

擧 

内側のブロックでも 「 num *」 という変数が宣言されています。この変数の 
スコープ も、この変数を宣言したところから始まり、ブロックの終わりで終わ 
っています。内側のブロックが終わったあとでは変数 num は使えないのです。 


内側のブロック内で外側のブロックにある変数である 「 str 」 や 「 res 」 や 
「 i 」 を使っていますよね。このように、内側のブロックからは外側のブロック 
にあるものは見えるようになっています。ブロックが、深くなれば深くなるほど、 
見える範囲が限定されていく仕組みです。 


グローバル変数 


では、ブロックの外側、つまりなんのブロックにも囲まれていない場所で変 
数を作るとどうなるでしょうか。答はそれは「グローバル変数」になり、どこ 
からもその変数が見えるようになります。 

KAG の TJS スクリプトでは、 「 Initialize . tjs 」 で多く見ることができます。た 
とえば、 

var dm = Debug.message ； 

というのがあります。これはどのブロックの中にも入っていない場所で宣言さ 
れた変数です。そのためこの 「 dm 」 という変数は、どこでも使うことができ 
るようになります。 


ローカル変数のススメ 


「グ U —バル変数はどこからも アクセス できて 便利 だよね」…確かにそ5ですね。「数 
の スコープが どこから始まってどこで終わって…」なんて気にする必要がありません。 

しかし、だからといって全部をグローバル変数にしてしまったらどういうこと 
が起きるでしょうか。たとえば KAG で使われている変数の数はざっと1000個以 
上あります。中には同じ名前の変数もたくさんあって、これをすべてグローバル 
変数にしてしまったら、同じ名前がぶつかってしまい、大変なことになります。 

もちろん、グローノ《ル変数はグローノマル変数なりに便利なところがあります 
が、どこからも見えるという必要がないならば、ローカル変数にするべきであ 
る、というのは TJS に限らず多くの言語で言われていることです。グローバル 
変数とロー カル変数、それぞれをうまく使い分けるのがコツです。 
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8-2 


鼸 IW ) ス 3 —プ 


スコープに 影響されるのは変数だけではありません。関数の スコープ も（変 
数のそれとは若干違いますが）あります。これらはあとで「クラス」の機能を 
説明するときに一緒に説明することになります。 

KAG の TJS スクリプトを見ると、いちばん外側のブロックの前に 「 class 」 
と書いてあって、そのブロックの中に変数や関数がたくさん書いてあると思い 
ますが、これが「クラス」です。このようなクラスを使わない場合は、関数は 
すべて グローバル 位置に宣言されると覚えておけば、今はよいでしよう。 


8-2 関数の スコープ 


Q3 


0 

0 

• 

0 

0 

0 

0 


HP 
BPI 
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第 5/ 章^^ 

廬卜、 ハー 


「決められた動作を繰り返し実行したいというとき 
のために、 TJS はいくつかの繰り返し(ループ)の 
方法を用意しています。ここで紹介するのはその 
うちの ひとつの while 文と Of ばれるものです。 









TJS にはいくつか繰り返し(ループ)を作る構文がありますが、 while 文はその 
うちのもっとも簡単な形のものです。 

とりあえず例を見て見ましょう。 「 UpdateConfig . tjs 」 には、以下のような 
while 文があります。 

while (oldconf ig [i] ! 二 end—mark && i < oldconf ig. count) 

{ 

content += oldconfig[i] + "¥n"； - 
i ++； 

} 

while 文はこのように、まず 「 while 」 と書き、その （） 内に条件式を書きま 
す。その次には文またはブロックが来ます。上記の例ではブロックが書いてあ 
りますね。この条件式が“真”の間中、ずっとこのブロックを実行するという 
意味になります。 

でも、「“真”の間中」というのは少し誤解を招く表現かもしれません 。 while 
文の動作を詳しく見てみましょう。 

① まず条件式を評価し、これが“偽”ならば文やブロックを実行せずに次に進む。 

② 文やブロックを実行する。 

③ 条件式を評価し、“偽，，ならば次に進み、“真”ならば②まで戻る。_ 

つまり、文やブロックを実行している途中にたとえ条件式が“偽”になって 
も、このループを抜けることはありません。常に条件式をチェックしているわ 
けではなくて、文やブロックを一回実行するごとにチェックしています。 

また、 while 文を実行しようとする時点ですでに条件式が“偽”になってい 
た場合は、文やブロックは1回も実行されないので、注意が必要です（後述の 
do 〜 while 文だと違います)。 

「ブロック」ではなく「文」を使った例も挙げましょう。同じ 「 UpdateCon - 
fig . tjsj にある while 文です。 

while (newconfig [i] ! = end_mark && 1 < newconrig. count) 

i + +; 
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回 

###___ 春 

この場合は、 「 newconfig [ i ] != end_mark && i < newconfig.countj という条 
件が“真”である限り 「 i +十」を実行するという意味です(ちなみに 「 i ++ 」 と 
は 「 i に1を加算する」という意味です)。 


break 文 


繰り返すのをブロックの途中でやめたい(ループの途中で抜け出したい）とい 
うときに使うのが 「 break 文」と呼ばれるものです。 


TJS 2 リファレンスにある以下の例を見て見ましょう。 
while(true) // break が実行されない限りは無限ループ 

{ 

if (f unc () ) break; // f unc () が真ならば while 終了 
func2 ()； // t で break が実行されなければここにくる 

} 

// break が実行されると、ここにくる 


この while 文は、条件式に 「 true 」 が指定されています。条件が常に“真”、 
つまり、ループを抜け出そうとしなければ永遠に繰り返す、「無限ループ」と 
呼ばれるものです(無限ループは吉里吉里の実行を止めてしまうので、書いて 
はいけません)。 

ただ、この例ではループを抜け出すために break 文が書いてあります 。 break 
文が実行されるとブロックの残りの実行をせずに、すぐに while 文の次に実行 
を移します。なにか条件によってループを抜け出したい場合がほとんどですか 
ら、 break 文は必ずといってよいほど if 文やそれに類するもので使われます。 


continued 


繰り返しの最初に戻りたいという場合に使うのが 「 continue 文」と呼ばれる 
ものです。 

例を見てみます〇 _ _ _ 

var i = 0; 

while (i < 5) 
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while 文 


funcO(); 

if (fund ()) continue; 

// funclO が true ならば、 i < 5 の条件式チェックがされ、真ならば 
//またブロックの先頭から実行される 
func2 () ； 


continue 文は、実行されるとブロックのそれよりも後を実行せずに、条件チ 
ェックに戻ります。その条件チェックが“真”ならば、またブロックの最初か 
ら実行されますし、“偽”ならば while ループから抜けることになります。 

continue 文も break 文同様、 if 文やそれに類するもので使われます。 


■ do 〜 while 文 


章の始めでもちょっとお話しましたが、 「 do 〜 while 文」というのがありま 
す 。 構文は以下のようになります 。_ 

do 

文またはブロック 
while (条件式）； 


これは最初に条件チェックを行なわないことを除けば、 while 文と同じです。 
「 do 」 の時点で条件が“偽”でも、文またはブロックが必ず1回は実行されま 
す0 





for 文も繰り返しを行なう場合に使う文ですが、 
while 文や do 〜 while 文より複雑な jb - プを作る 
ことができます。 






for 文 



while 文や do 〜 while 文も for 文と同じく、繰り返しを行なうための文です 


が、 for 文はもうちょっと高機能なものです。 


いちばんオーソドックスな例を見てみましよう 。「 History Lay er . tjs 」 の 
fdisplnitj という関数には以下のような for 文があります。 



for の次の （） の中には「;」（セミコロン）で区切られた 3 つの部分があるの 
が分かるでしょうか。前から順に、「第1節」「第 2 節」「第 3 節」と呼んでい 
て、それぞれ役割が決まっています。 

第 1節は、ループに入る前に実行する式を指定します。この例では、変数 
「 I 」に「0」を代入しています。 

第 2節には条件式を指定します。 「 while 」 と同じで、ここの条件式が“真” 
であるあいだ中、文やブロックを繰り返し実行します。この例では、 「 i < 
dataLines 」 という条件が“真”である間実行されます。 

第 3節には、文やブロックの実行の1回ごとに実行する式を指定します。こ 
の例では、 「 i +十」、つまり 「 i 」 に「1」を足しています。 

ところで、上で例に挙げた for 文はどのように動作するのでしょうか。 

変数 「 i 」 は最初に「0」になります。次に 「 i < dataLines 」 という条件がチ 
ェックされます。 「 i 」 が 「 dataLines 」 よりも小さくない場合は、文またはブロ 
ックは1回も実行されません。 「 i 」 が 「 dataLines 」 よりも小さければ 「 draw - 
Line ( i );」 が実行されます。 

1回、文またはブロックが実行された後は 「 i +十」が実行されます。 「 i 」 に 
「1」が加算されます。そしてまた条件がチェックされ、 「 i 」 が 「 drawLine 」 より 
も小さい場合はずっと rdrawLine ( i )」 と 「 i ++」 が実行されることになります。 
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for 文の使い方 fia 

たとえば、 「 dataLines 」 が「4」の場合は、 「 i 」 は「0」「1」「2」「3」と変化 
しながら 「 drawLine ®」 が4回実行されます。「5」ならば、「0」「1」「2」「3」 

「4」と変化しながら5回実行されます。つまり、 「 dataLines 」 で指定した回数 
だけ、 「 drawLine ®」 が実行されることになり、しかも 「 i 」 は「0」から順に 
1ずつ繰り上がってます。 


for * 文は、このように何かを指定回数ぶんだけ実行したいというときによく 
使われるものです。使い慣れないうちは、「節のどれがどういう機能だったか 
な？」と分からなくなってしまいがちですが、そのうちに while 文よりも書く 
のが楽になってくるでしよう。 


上記の例は while 文を使えば、以下のように書くこともできます。 



for 文を while 文に書き直した例をお見せしましたが、 for 文中の continue 文 
は while 文中のそれと違うので、注意が必要です。 


while 文の 「 continue 」 は、ブロックの残りを実行せずに条件判断に戻るも 
のでしたが、 for 文の 「 continue 」 は、第 3 節を実行してから条件判断に戻り 
ます。 


例を見てみましょう。「 MessageLayer . tjs 」 の「 internalAssign 」 という関数 
には、以下のような for 文があります。 
for(var i = si.count-1 ； i>=0 ； i--) 

{ 

if (si[i] === void) continue; 

(略） 
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氺官言 

どのような変数を使う 
かあらかじめ決定する 
こと。 


for 文 


continue が実行されると、「い」が実行されて、 「 i >=0」 という条件式がチ 
エックされ、もし条件が真ならば、再びこのブロックが実行されます。 

このように for 文における continue 文は、「文やブロックの実行の1回ごとに 
実行する式」を忘れずに実行してくれます。 


節の var 


第1節に 「 var 」 が書いてある for 文を見掛けると思います。たとえば、 


「 Utils . tjs 」 の「 number _ formatJ 関数には以下のような for 文があります 0 


for(var i = 0; i < n_len ； 

/ 

i++) 


1 

var digit = n[i ]； 



if (digit >= ' 0 ' ScSc 

digit <= '9 

')n_digits ++; 

else if (digit =='.' 

} 

|| digit == 

= ' e ' ) break; 


「 var 」 をこのように第1節に書くと、この時点で変数を宣言*できます。こ 
の変数のスコープは for 文の終わりまでです。つまり、 for 文が終わった時点で 
この変数 「 i 」 は使えなくなります。これはループだけに用いる変数を使うの 
に便利です。 
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switch 文は、値それぞれについて場合分けした処 
理_なうときに便利です。 











switch 文は、ある値があって、その値がどの値と同じ時にどのような処理を 


するかを書き連ねることができるものです。 


例を見てみましょう。 「 Utils . tjs 」 に 「 str 2 num 」 関数がありますが、そこに 
ある switch 文です。 


switch (ch) 


{ 

case " 0 " ： 

res+= 

" 0"; break ; 

case "1" 

: res+ 

=" l "; break ; 


(略） 


case " 一"： 

: res+= 

" - ； break ; 

case ，一"： 

res+= 

"-"; break ; 

default : res+=ch; 

break; 

} 




switch の後の （） の中には式を書きます。この式の結果が、 「 case 」 の後に 
書かれたものと一致する場合、その 「 case 」 のところの文が実行される仕組 
みです。たとえば、 「 ch 」 が" 0" ならば、 「 res +=”0"; break ;」 という文が実 
行されます。 

「 default :」 は、どれにも当てはまらなかった場合に実行されるものです。 


switch 文に 3S ける break 


上記の例で、いちいち break 文が書いてあるのに注目してください 。 break 
文は、ループで用いる 「 break 」 と同じように、この文が書かれた時点で switch 
文を抜けます。 break 文を書くと switch 文を抜けるということは、 break 文を 
書かなかった場合は抜けないということです。その場合は、次に書かれた 
「 case 」 の内容を実行してしまうので、注意が必要です。 
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TJS 2 はオブジェクト指向的な考え方でプ□グラ 
ミングができる言語です。この章では、「オブジェ 
クト」の概念や使し、方につし、て説明します。 







「データ型」のところで、 TJS の扱えるデータ型には種類がいくつかあると 
話したと思います。ほかの言語を知っている方の中には、そこに挙げたデータ 
型の中にはいくつか足りない型、たとえば「配列型」が無いので、「配列型は 
どうなるんだ」などと思った方もいるかもしれません。 

「オブジェクト*」は英語で「もの」という意味で、特に何か特定のものを 
具体的に示す単語ではありません。 TJS におけるオブジヱクトも、なにか特定 
の「これ！」といったものではありません。実際オブジェクトと言われるもの 
の種類はけっこう多くて、先に説明した関数もオブジェクトの一種ですし、後 
で説明するクラスもオブジヱクトの一種であり、配列や辞書配列もそうです。 


実際のところ、いろいろなデータのうち、文字列型でも数値でもオクテット 
列型でも void でもなければ、それはオブジヱクト型で、 TJS から見ればオブジ 
ェクトとして扱われるものなのです。 


氺メンバ 
member 


メンバ選択演算子 


オブジェクトは、たいていメンバ*を持っています。「メンバ」とは、そのオブジェク 
卜が持っている変数や関数や他のオブジェクトなどのことです。 TJS は、そのメ 
ンバにアクセスするために「メンバ選択演算子」というものをもっています。 


たとえば 、 “Hello world !” のところで、以下のような式を使いました。 
System.inform("Hello world!") _ — 


この「 System . inform 」 というところに注目してください。「 System 」 の次に「•」（ド 
ット）が書いてあって、次に 「 inform 」 と書いてありますね。この「」（ドット）ば「直接 
メンバ選択演算子」 といいます。左側に書いたオブジェクトの中の、右側に書いた 
メ ンバに アクセスするよ、という動作をする演算子です。この場合は 「 System 」 と 
いうオブジェクトの中の 「 inform 」 というメ ンバに アクセスする、という意味です。 
日本語の「の」と考えるとわかりやすいでしよう。 「 System の inform 」 なのです。 


メンバ選択演算子にはもうひとつ、「間接メンバ選択演算子」というのもあ 
りますが、これは次の章の辞書配列のところで説明します。 
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i 2- i オブジェク トとは？ nn 

IE 3 ォブジェク， 

TJS が扱えるオブジェクトについて紹介します。 

拳###### 

■ グローバル • オブジェクト | 


TJS が持っているやや特殊なオブジェクトとして、「グローバル.オブジェク 
卜*」というのがあります。グローバル•オブジェクトはグローバル位置に宣 

* グローバル.オブジ 
エクト 

global object 


言されたもの、つまりグローバル変数や普通の関数などをもっているオブジェ 
クトです。これには 「 global 」 でアクセスすることができます。 


たとえば、グローノ ゞ ル位置で以下のような変数を宣言したとします。 



この変数 「 foo 」 はグローバル変数として宣言されました。実は、この時点 
でグローバル•オブジェクトは 「 f 00 」 というメンバをもつことになります。 

試しに、スクリプト•エディタで 「varfoo = 5;」 と入力して実行してみてく 
ださい。次に、コンソールで 「 globalioo 」 と入力してみてください。「5」と 
表示されるはずです。 

逆に、 「 global.foo = l 」 とコンソールに入力すれば、変数 「 foo 」 は「1」と 
いう値をもつことになります。コンソールに 「 foo 」 と入力してみてください。 
「1」と表示されたはずです。 

また、今までたびたび使ってきた 「 System . inform 」 の 「 System 」 というのも 
「 global 」 のメンバです。ですから、たとえば rSystem . inform (" Helloworld!");J 
を「 global . System . inform (" Helloworld !”) ;」としてもちゃんと動きます。 


■関数とプロパティ 


関数もオブジェクトとして扱われます。オブジェクトは変数に入れることが 
できるので、変数に関数を入れてアクセスするようなことができます。 

たとえば、以下のようなスクリプトを書くことができます。 



この例では、変数 foo に関数 add を代入しています。すると、 foo があたかも 
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オブジェクト 

# 

関数であるかのように使えるようになります。 


* プロパティ 

property 

特性 


「プロ ハ。ティ*」というのは、ここでは説明しませんが、一見変数のように見える 
関数のようなものです。変数のように値を設定したり、値を取り出したりできま 
すが、そのときに関数のように特定のスクリプトを実行することができるものです。 



「クラス」は 14 章で詳しく説明しますが、オブジェクトを作るためのひな 
形のようなものです。どのような種類のオブジェクトを作るか、どんな変数が 
あってどんな関数を持っているのか、を知っているのが「クラス」です。 


実は、クラスそのものもオブジェクトの一種です。 C ++ などの言語ではクラ 
スは「型」として扱われ、オブジェクトとは厳しく区別されるのですが 、 TJS 
では同じ種類のものとして扱います。クラスを変数に入れてほかの関数に渡 
し、そのクラスからオブジヱクトを作るといった使い方もできます。 


配列と辞書配列 


TJS においては、配列もオブジヱクトの一種です。配列が番号で要素を管理 
するのに対し、名前で要素を管理する「辞書配列」というのもあります。ど 
ちらも次の章で詳しく解説します。 


文字列に対する操作 


オブジヱクトに対してメンバ選択演算子を使うとそのメンバにアクセスする 
ことができると話しました。しかし実は、文字列や文字列の入っている変数に 
対しても、メンバ選択演算子を使うことができます。文字列は TJS においては 
オブジェクトではないのですが、擬似的にまるでオブジェクトであるかのように 
メンバ選択演算子を使うことができます。 


たとえば、文字列の長さを表わす 「 length 」 というメンバがあります。試し 
にコンソールから 「 n abc n . length 」 と入力してみましょう。文字列 「" abc n 」 は 3 文 
字の長さがありますから、「3」と表示されたと思います。もちろん、変数に対 
しても同じで、たとえば変数 「 hoge 」 に 「 n abc n 」 という文字列が入っていれ 
ば、 「 hoge . length 」 は「3」になります。 

文字列に対する操作はいくつか便利なものがあります。 「 TJS 2 リファレン 
ス」を見てみてください。 
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大量のデータを使いたいときに、その数だけ変数 
を分作っていたら大変です。効率良く大量のデー 
夕を処理したいと思ったら、 fl 己列」を使し、ましよう。 








「配列」は、大量のデータを、通し番号をつけて管理できるものです。た 
とえば、1000個のものを記憶したいからと言って変数を1000個宣言していた 
ら大変なことになります。配列を使えば、配列の中にその1000個を入れてお 
くことができます。 


* オブジェクト 
object 

* クラス 
class 


* 筆者注 

new Array (); の代わり 
に []; としても配列ォブ 
ジェクトを作成できま 
す。 


TJS では配列もオブジェクト*です。配列は 「 Array 」 というクラス*から作 
られるオブジェクトです。「クラス」は、簡単にいうとオブジェクトを作るた 
めのひな形なのですが、これは次の章で詳しく説明します。 


■ 配列の作成 


配列は使う前に「配列オブジェクト」を作らなければなりません。配列オブ 
ジェクトを作るには、 new 演算子を使って、以下のようにします。 
var ar = new Array (); 


このように 「 newArrayO ;」 とすることで配列オブジェクトを作ることがで 
きます。上記の例では、変数 ar にそのオブジェクトを入れています。 


配列のアクセス 


配列の各要素は、「0」から始まる通し番号で管理されます。この通し番号 
を添え字と呼びます。添え字を指定するには [] 演算子(間接メンバ選択演算 
子)を使います。 

たとえば、以下のように使います。 
ar [ 0 ] = " zero '，； 
ar[ 1 ] = "one "； 
ar[2] = "two "； 


この例では、〇番目に 「" zero ”」 を、 1 番目に P ’ one n J を、2番目に PW ，」 
を入れています。この状態でたとえば 「 System . inform ( ar [0])」 とすれば 
「 zero 」 と表示されることになります。 
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何も値が代入されていない要素は 「 void 」 であると見なされます。 







13 -\ 配列 BIEi 


配列の大きさ 


配列の要素数(配列の大きさ）は count プロパティで参照できます(プロパテ 
ィはオブジェクトのメンバで、変数のようなものです)。 

たとえば、上記の例の要素数を確かめたかったら、コンソールか何かで 
「 ar . count 」 としてみましょう。 ar 変数に入っている配列オブジェクトのもって 
いる要素数である「3」と表示されるはずです。 「 ar . count 」 になにか値を入 
れても要素数を変えることができます。 


配列の大きさは、その配列に代入するときに使った添え字のいちばん大きな 
ものになります。上記で言えば 「 ar [2]」 がいちばん大きいですから、要素数 
は「3」になります（添え字は「0」から始まっていることに注意してください)。 

配列の大きさは好きなだけ大きくできますが、そのぶん、大きなメモリが必 
要です。 
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配列 



辞 is _ 林 # i_ 



TJS 2 は「辞書配列」と呼ばれるものもサポートします。辞書配列も配列の 
一種ですが、こちらは通し番号で管理するのではなくて、「名前」で管理しま 
す。名前に結び付けられた値を取り出す様子から「連想配列」などと呼ばれ 
ることもあります。 


* 筆者注 

new DictionaryO ; の代 
わりに%[];としても配 
列ォブジェクトを作成 
できます。 


辞書配列の作成 


辞書配列を作るには、普通の配列と同じように new 演算子を使い、以下の 
ようにします。 

var die = new Dictionary ()； 


辞書配列のアクセス 


配列の場合は、要素のアクセスに [] 演算子を指定しました。辞書配列の場 

合 も同じです。 ____ 

die [’zero'] = 0 ; 
die [ f one ']=1; 
die [’two ' ] = 2 ； 


これは 「 f zero f 」 という名前の要素 ( zero という名前のメンバ）に「0」を、 
Pone リという名前の要素に「1」を、 「’ two リという名前の要素に「2」を代 
入しています。この状態で 「 System . inform ( dicpzerol );」 とすれば、「0」と表 
示されるはずです。. 

名前は重複することはありません。たとえば、この状態で 「 dierzeny ] = ”ぜ 
5 M ; J とすれば、 rdierzero ']] という要素の内容は「"ぜろ”」に置き換わりま 
す。 r ' zero ' J という名前の要素が2つになるわけではありません。 

要素を削除するには delete 演算子を使います。たとえば 「 deletedicptwo f ];」 
とすれば、 f ' two ' J という名前の要素を削除できます。 


初めて使われた名前の要素には 「 void 」 が入っているものと見なされます。 
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K AG の変数と辞書配列 


さて、前に KAG の変数は辞書配列であると話しました。実は 「 f 」 や 「 sf 」 
は辞書配列なのです。たとえばゲーム変数 「 f . hoge 」 は、 「 f 」 という辞書配列 
の 「 hoge 」 という名前をもった要素にアクセスしていたのでした。 


纏配列 

_ # _籲_參參 


「あれ？辞書配列の要素には [] 演算子でアクセスするんじゃないの？」と 
思うかもしれません。「•」（ドット）は直接メンバ選択演算子、 [] は間接メンバ 
選択演算子です。直接か間接かの違いはあっても、両者は同じ仲間の演算子 
なのです。「直接メンバ選択演算子」は、「.」の右側にメンバの名前を「直接 
的に」書いてアクセスします。それに対し、「間接メンバ選択演算子」は、 [] 
の中にメンバの名前を文字列と して 「間接的に」書いてアクセスします。 


「直接メンバ選択演算子」を使うと 「 f . hoge 」 と書くことができますが、 
「間接メンバ選択演算子」を使うと rf [ f hoge f ] J とかけます。両者はまったく 
同じ意味になります。 

「間接メンバ選択演算子」の利点は、 [] 内に変数を指定できるということ 
です。たとえば、「 var name = , f hoge n ; J として、「 name 」 という変数には 
「” ho g e ”」 という文字列が入っているとします。そこで 「 f [ name ]」 と書けば、 
rf [ M hoge , f ] J と同じ意味、つまり 「 f . hoge 」 にアクセスできるのです。 
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配列の コピー 



配列や辞書配列をコピーしたい場合には、どのようにすればよいでしょう 
か。配列に限らないことなのですが、 TJS はオブジェクトを「参照」という方 
法で扱います。 



配列をコピーしたいとして、たとえば以下のようにしてみましょう。変数 
「 ar 」 には配列オブジヱクトを入れて、それを変数 「 dar 」 にコピーしたいとし 
ます。 


var ar = new Array ()； 

ar[0] = "zero"; ar[1]="one"; ar[2] = "two"; 
var dar = ar; 


はたしてこれで良いのでしようか。結論から言うと、これでは駄目なのです。 
試しにこのスクリプトをスクリプト • エディタから実行してください。その 
後、コンソールから 「 ar [0]」 の内容を確かめてください。 「" zero 叫と表示さ 
れたと思います。では、 「 dar [0] = ” ぜろ叫とコンソールから入力し、 「 dar [0]」 
に「"ぜろ”」を入れます。その後、またコンソールから 「 ar [0]」 の内容をみて 
みてください。「”ぜろ”」になっていると思います。つまり、コピー先の内容 
を書き換えたはずが、コピー元の内容も書き換わってしまっているのです。 


これは、 TJS が「オブジェクト」を「=」（イコール)演算子や関数の引数へ 
の引き渡しなどでほかの変数などに入れるときに、「コピー」ではなくて「参 
照」を増やすという方法で行なうからです。これは配列に限らず、 TJS がオブ 
ジェクトとして扱うもの全部に言えます。 


本 ^ *=*=£ 

米国のベル研究所で開 
発された高級言語。 
UNIX における標準開発 

aaao 


「参照」は C 言語などの言語を使っている方には「ポインタ」の方が分か 
りやすいかもしれません。実体となるオブジヱクトがあって、それを「指し示 
す」、つまり参照する変数が増えるだけなのです。 

上記の例でいえば、 [ newArray 0 J で作ったオブジェクトの実体はまず 「 ar 」 
という変数から参照されています。しかし、そのあと 「 dar 」 という変数から 
も参照されます。結局、 「 ar 」 も 「 dar 」 も同じオブジェクトを指し示している 
ことになるのです。 
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配列の コピー 



讓癃_拳### 



配列の コピー 


配列を本当にコピーしたい場合は、配列の 「 assign 」 というメンバ関数を使 
う必要があります。 

上記の 「dar = ar ;」 は以下のようになります。 
var dar = new Array ()； 
dar.assign(ar )； 


まず、 「 dar 」 に新しい配列オブジヱクトを作って入れます。そのあと、その 
新しい配列のメンバ関数である 「 assign 」 を呼び出し、 「 ar 」 の内容をコピー 
します。これで、 「 dar 」 に 「 ar 」 の内容がすべてコピーされるのです 0 


■ 辞書配列のコピー 


辞書配列のコピーはちょっとやっかいです。辞書配列オブジヱクトは作られ 
た直後はメンバを何も持っていないからです。 「 assign 」 というメンバさえあり 
ませんので、上記の配列と同じ方法は使えません。 

どうするのかといえば、たとえば 「 ddic 」 という変数に 「 die 」 という辞書 
配列をコピーしたければ、 

var ddic = new Dictionary () ; 

(Dictionary.assign incontextof ddic) (die); 

と書く必要があります。 

ややこしいですが、 「 Dictionary . assign 」 という関数を、コピー先である 
「 ddic 」 というオブジェクトに対して呼び出しています。引数にはコピー元の 
辞書配列を指定します。とりあえずはこのように書くものだ、と覚えておけば 
よいと思います。 
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クラスとは 1 ? 

TJS には多くの種類の「オブジェクト」があるという話をしました。しかし、 
その「種類」はどのように決定されるのでしょうか。 

そのカギを握るのが、「クラス」と呼ばれるものです。クラスはオブジェク 
卜の「ひな形」のようなものです。 TJS では通常、オブジェクトを作るときに 
この「クラス」を用いて作ります。オブジェクトの「種類」やその「性質」を 
決めるものが、クラスなのです。 


14 


クラス 


% 

m 


翁癱參截#響 
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KAG の TJS スクリプトを見ると 「 class 」、 つまり「クラス」を表わす表記 
がよく出てくると思います。事実、 KAG ではほとんどの記述が class に続くブ 
ロック 内に書いてあります。 KAG を理解するにはこの「クラス」を知り、才 
ブジヱクトとどう関わりがあるのかも知ることが重要です。 


クラスを見てみよう 


比較的独立していて分かりやすい例が 「 YesNoDialog . tjs 」 にあるので、見 
てみましよう。ここには rYesNoDialogWindowJ というクラスが定義されて 
います。このクラスは「はい」か「いいえ」をユーザに選択させるためのウイ 
ンドウを作るためのひな形です。 KAG では終了しようとするときに「終了し 
ますか？」と表示されますが、あれを司っているのがこのクラスから作られた 
オブジヱクトなのです。 

このクラスの構造は、大まかに以下のようになっています(一部省略してあ 
ります)。 


class YesNoDialogWindow extends Window 
{ 

var yesButton ； 
var noButton ； 
var result = false ; 

function YesNoDialogWindow (message, cap) 
{ 

super.window ()； 

(略） 
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14-1 クラスとは？ 

:/ ::纏^^^ : V .: i I .:.::....'.....:.......:.:.. 二 

_ #參纛 

> 

function finalize () 

{ 

super , finalize (...); 

} 

function action (ev) 

{ 

(略） 

} 

function onKeyDown (key, shift) 

{ 

Super . onKeyDown (...); 

(略） 


クラスは 「 class 」 から始まるブロックです。この中に、このクラスから作 
られるオブジヱクトがどのようなメンバをもつか、すなわちどのような性質を 
もつかを記述することになります。 


Q3 

響#❿ 
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氺音音 

どのような変数を使う 
かあらかじめ決定する 
こと。 


* メソッド 

method 


実際には「プロパティ」 
というのも記述できま 
すがここでは説明しま 
せん。 


クラス 


14-2 


クラス内に IB 逋するちの 


class に続くブロック中には、変数や関数を書くことができます。 


メンバ変数 


クラスでは、オブジェクトが作られるときに、そのオブジェクトがあらかじ 
めもつ変数、「メンバ変数」を宣言*できます。記述の方法は普通の変数と同 
じで、 fvarj を使って宣言します。 


メンバ関数(メソッド) 


オブジェクトがもつ関数を宣言することもできます。記述の方法は普通の関 
数と同じで、 function を使って宣言します。「メンバ関数」のことをよく「メ 
ソッド*」とも呼びます。 

メンバ関数の中では、オブジェクトのメンバ変数にそのままアクセスするこ 
とができます。オブジェクトのメンバ変数には「」（ドット）演算子を使う、と 
書きましたが、自分自身のオブジヱクトのメンバ変数にアクセスする限りは、 
その必要はありません。 

たとえばメンバ関数 「 action 」 には 「result = true ;」 や 「result = false ;」 と 
いう記述がありますが、この result はメンバ変数ですね。クラス内で 「 var 」 を 
使って宣言されている変数です。 
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14-3 オブジェクトの作成と削除 | 

_參參# _ # _ 

オブジェクトの作成と削除 


クラスそれ自体は単なるひな形なので、実際にはこれからオブジヱクトを作 
らなければなりません。オブジヱクトを作るには、今までにも出てきましたが、 
「 new 」 を使 t 、ます。クラス rYesNoDialogWindowJ からオブジェクトを作っ 
ている部分が、 「 YesNoDialog . tjs 」 にあるので、見てみましょう。 

この関数 「 askYesNo 」 は、先ほどのクラスを使って指定されたメッセージ 
を表示し、ユーザーに「はい」か「いいえ」を選んでもらう関数です。 


function askYesNo (message, caption = " 確認"） 

{ 

var win = new YesNoDialogWindow(message, caption )； 
win.showModal ()； 
var res = win.result; 

invalidate win ； 
return res ； 


「 new 」 は演算子で、 「 new 」 の次に書いたクラスから、オブジヱクトを作 
る、という意味になります。ここでは 「 newYesNoDialogWindow 」 としてい 
ますね。その次に （） があって、この中には「コンストラクタ*」（後で説明し 
ます)に渡す引数を指定します。 

作ったオブジェクトは変数 win に入ります。 「 win . showModalO 」 では、作 
ったオブジェクトの 「 showModal 」 という関数を呼び出しています。 

「 var res = win . result ;」 では、作成したオブジェクトのメンバ変数である 
「 result 」 を変数 res に入れています。このメンバ変数は、先ほどのクラス内で 
「 var 」 を使って宣言したものです。 


* コンス トラクタ 
constructor 


コンストラクタとは 


「コンストラクタ」は日本語では「構築子」と呼ばれるもので、特別なメ 
ンバ関数です。オブジェクトが作られるときには、必ずこの関数が呼ばれます。 

コンストラクタは「クラス名と同じ名前になる」という特別なルールがあり 
ます。先ほどのクラス 「 YesNoDialogWindow 」 にも 「 YesNoDialogWindow 」 
という関数がありますが、これがコンストラクタです。 
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クラス 


new 演算子にはコンストラクタに渡す引数を指定する、といいました。メンバ関 
数 「 YesNoDialogWindow 」 には 「 message 」 と 「 cap 」 という2つの引数がありま 
す。先ほどの関数 「 askYesNo 」 では、この引数を 「 new 」 で指定したのです。 


:クトを削除する 


オブジェクトは作ったら「削除」しなければなりません。幸い、 TJS は作ったオブ 
ジェクトは自動的に削除されます(例外もあります)。「配列」の章で「参照」とい 
うお話をしました。この「参照」がすべてなくなる、つまりオブジェクトがどこか 
らも参照されなくなると、作られたオブジェクトは自動的に「削除」されます。 


■ 削除と無効化 


オブジヱクトが削除される前に、 TJS では「無効化」という段階を踏みま 
す。「無効化」とは、「そのオブジェクトは使えない」、つまり「そのオブジェ 
クトは無効」とすることです。 

無効化は削除の前に必ず起こるもので、削除が自動的に起こる場合は無効 
化も自動的に起こります。しかし、意図的にオブジヱクトを無効化させること 
もできます。それが invalidate 演算子です。 

先ほどの関数 askYesNo にもありました。 「 invalidatewin ;」 として、変数 win 
が参照しているオブジヱクトを無効化したのです。 

無効化するとそのオブジェクトはもう使えなくなります。あとはそのオブジ 
ェクトは TJS によって自動的に削除されるのを待つだけとなります。 


* 筆者注 

オブジェクトをすぐ 
に削除しないことで実 
行効率を上げる仕組み 
のことを「ガベージ. 
コレクション」 といい 
ます。 


削除のタイミング 


参照がすべてなくなるとオブジェクトは自動的に削除されるといいましたが、こ 
れはちょっと嘘なのです実は参照がすべてなくなってもオブジェクトが即、削 
除される保証はありません。 TJS は参照がすべてなくなってもオブジヱクトをすぐ 
には削除しないのです*。削除のタイミングが分からない、ということになります。 

これは実行効率を上げるための工夫なのですが、これが災いすることがあり 
ます。自動的に削除が起こる前に自動的に無効化が起こるのですが、削除の 
タイミングが分からないということは、この無効化のタイミングでさえ、予測 
できないものとなるのです。 

無効化は削除と違い、後述の finalize メソッドを呼び出すことがあり、この 
関数が呼ばれるタイミングが予測できないというのが問題になる場合がありま 
す。そのため、明示的に invalidate 演算子を使っておけば、確実にその時点で 
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オブジェクトを無効化し、 finalize メソッドを呼んでおける、ということになるのです。 


invalidate 演算子を使うか否かは難しいところですが、一応、「作ったオブ 
ジェクトは必ず invalidate する」と覚えておけばよいでしよう。ただし、 「 Array 」 
や「 Dictionary 」 クラス、つまり配列や辞書配列などや、正規表現を使うため 
の 「 RegExp 」 クラス、「例外*」の際に使う 「 Exception 」 クラスなどは、 
「 invalidate 」 を使わず、無効化も TJS 側に任せてしまうことがよくあります。 
これらは無効化時には特にこれといって何も しないので 「 invalidate 」 を使わ 
なくても特に問題がないのです。それ以外は、普通は 「 invalidate 」 を使います。 


氺例夕 t 

通常の処理中では考え 
られない、例外的なエ 
ラーな どの処理。 


finalize メソッ 


オブジェクトが無効化されるときに呼ばれるのがこの 「 finalize 」 というメン 
バ関数、 「 finalize メソッド」です。オブジヱクトが無効化、つまり「このオブ 
ジェクトは使えない(使わない)」とされるときに呼ばれる関数ですから、ここ 
には「後処理」、つまりオブジェクトの後片付けの処理を書くことになります。 

「 finalize メソッド」は、「コンストラクタ」とは反対の動作をするという意 
味で、「デストラクタ」（、消滅子）と呼ばれることもあります。 


[クトを作らないクラス 


「クラスはオブジェクトのひな形である」と話しましたが、例外があって、 
ひな形として機能しないクラスもあります。 

クラスもオブジェクトの一種なのですが、このクラスというオブジェクトの特徴と 
して、クラス内で宣言したメンバ関数をすべてメンバとして持っているというこ 
とが挙げられます。通常はメンバ関数は、そのクラスから new 演算子でオブジ 
ヱクトが作られることを想定して書きますが、そうでなく、クラス内に単に関数 
をいくつか書けば、その関数群をクラスという形でまとめることができるのです。 

「吉里吉里」が提供しているいくつかのクラスがそれで、たとえば今までに何度 
か 「 System . inform 」 の形で紹介した 「 System 」 というのも、実はクラスなのです。 

ただし、 「 System 」 はクラスだといっても 「 newSystemO 」 のような使い方 
はしません。 「 System 」 というクラスは「吉里吉里」本体や、「吉里吉里」が 
実行されている環境に関する情報を取得したり、設定したりするためのクラス 
で、単にこの機能に属する関数をクラスの形にまとめただけのものなのです。 
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クラスに関する非常に重要な概念として「継承」というものがあります。ク 
ラスはオブジヱクトの「種類」や「性質」を決めるものですが、継承によって 
引き継がれるのは、この「種類」や「性質」です。 


私たちの世界でもこの継承という概念は多くに当てはまります。 

私たち人間を考えてみましょう。私たち「人間」は「ほ乳類」ですね。「人 
間」は、子が母の母乳で育つという「ほ乳類」の性質を「継承」しています。 
その「ほ乳類」は「動物」の「よく動いて活動する」という性質を「継承」 
しています。その「動物」は「生きている」という「生物」の性質を「継承」 
しています。私たち人間は、生物であり、動物であり、ほ乳類であり、人間 
であり、継承元の性質をすべて引き継いでいるのです。 

また、「生物—動物-ほ乳類—人間」という順では、より「抽象的」な「生 
物」から、より「具体的」な「人間」へと継承されていっているのが分かる 
と思います。 

TJS のクラスもほかのクラスの性質を「継承」することができます。たとえ 
ば、先ほどの rYesNoDialogWindowJ というクラスは、 「 Window 」 というク 
ラスを「継承」しています。 Window は「吉里吉里」が提供するクラスで、い 
わゆる「ウインドウ」のひな形です。 「 YesNoDialogWindow 」 は、この「ウイ 
ンドウである」という性質を継承しつつ、「『はい』か『いいえ』かを ユーザー 
に選択させるためのウィンドウ」という性質をもつひな形なのです。 


■ 継承に関する用語 


継承に関する用語はいくつかあります。 


•継承元の（より抽象的な）クラスを「親クラス」あるいは「スーパークラス」 
と呼びます。 

•継承した（より具体的な）クラスを「子クラス」あるいは「サブクラス」と呼 
びます。 

• クラスを継承させることを「親クラスから子クラスを派生する」とも呼びます。 
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継承のしかた 


クラスをクラスから継承させるには、 「 extends 」 を使います。先ほどのク 
ラス fYesNoDialogWindowJ の class 宣言のところを見てください。 


class YesNoDialogWindow extends Window 
となっていますね。これは 「 YesNoDialogWindow 」 を 「 Window 」 から継承 
させる、つまり 「 Window 」 から 「 YesNoDialogWindow 」 を派生させていま 
す。 

こうすることで、 YesNoDialogWindow から作成されたオブジェクトは、 
Window クラスのメンバもすベてもつことになります。 


先ほどの関数 「 askYesNo 」 の中で、 「 win . showModalO ;」 というのがあり 
ました。 「 showModal 」 は 「 YesNoDialogWindow 」 内で定義されていないメ 
ンバ関数なのでいったいどうしたものか、と思った方もいるかと思いますが、 
これは実は Window クラスに属するメンバ関数で、「ウィンドウを表示し、そ 
のウインドウが閉じるまで、ほかのウインドウへのアクセスを禁止する」とい 
う機能をもったメンバ関数です。 


継承とコンストラクタ 


先ほどのクラス 「 YesNoDialogWindow 」 のコンストラクタ、つまり関数 
fYesNoDialogWindow ] を見てみてください。 


super.Window () ； 

とありますね。この super は「スーパークラス」、つまり「親クラス」を表わ 
すものです。 

親クラスは Window クラスですが、 Window クラスにもコンストラクタがあ 
り、その名前はクラス名と同じ 「 Window 」 です。つまり、この 「 super . Win - 
dowO 」 は、親クラスのコンストラクタである Window というメンバ関数を呼 
んでいるのです。 

このように、クラスを継承したら、その親クラスのコンストラクタを、子ク 
ラス内のコンストラクタから呼ばなければなりません。 
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継承と finalize 


finalize メソッドも、親クラスのものを呼ばなければなりません。クラス 
「YesNoDialogWindow」 の 「finalize」 にも以下の記述があります。 


super.finalize(...); 


ここで親クラスの 「finalize」 というメソッドを呼び出しています。関数の引 
数のところにある「•••」（ドット 3 つ）は、この関数に渡された引数をそのまま 
別の関数に引き渡す、という意味です。実際には仕様として 「finalize」 には 
引数は何も渡されないのですが、慣用的にこのように書いています。 


オーバ-ライ 


継承に付随する、これまた重要な概念として「オーバーライド」というもの 
があります。 

オーバーライドは「優先する」という意味で、この場合は「子クラスのメン 
バ関数が親クラスのメンバ関数 ( こ優先する」という意味です。 

どういうことかというと、子クラスでは親クラスにあるメンバ関数と同名の 
メンバ関数を宣言できます。このとき、親クラスのメンバ関数は子クラスのメ 
ンバ関数に隠されてしまいます。 


先ほどのクラス「 YesNoDialogWindow」 の「 onKeyDown」 という関数を見 
てみてください。同名の関数は「吉里吉里2」のリファレンスを見ても分かる 
とおり、親クラスの Window クラスにもあります。このようにすると、作られ 
たオブジェクトの 「onKeyDown」 というメンバ関数は、子クラスの 「onKey- 
Down」 になり、親クラスの 「onKeyDown」 ではなくなるのです。 


隠された親クラスのメンバはどうなるんだ、ということになりますが、これ 
は親クラスを表わす super でアクセスできます。クラス 「YesNoDialogWin- 
dowj にも 「s 叩 er.onKeyDown (•••);」という記述があります。これは親クラス 
の「 onKeyDown」 を呼んでいるのです。 


そういえば「 finalize」 もそうですね。「 finalize」 も親クラスの「 finalize」 を 
オーバーライドする形で書き、その中で親クラスの同名のメソッドを呼びます。 
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❿修 


オーバーライドは、親クラスのメソッドの性質を変えたいが、名前はそのま 

まにしたい(あるいは名前をそのままにしなければならない)、という場合によ 

く使います。よく使うのは「イベント」、つまり「吉里吉里」側から呼ばれる 

メンバ関数を記述するときで、「吉里吉里Iが提供するクラスにはあらかじめ 

動作が決まったメンバ関数が定義されています。動作が決まった、といっても 

ほとんどは「何もしない」という動作ですが、この動作を変えたいときに、そ 

のメンバ関数をオーバーライドして動作を記述する、ということを行ないます。 

j 先ほどの 「onKeyDown」 は「キーが押された」ときに呼ばれるメンバ関数 

= ですが、クラス r YesNoDialogWindowJ ではこのメンバ関数をオーバーライ 

" ドして、キーが押されたときに特別な処理ができるようにしてあります。 

5 

オーバーライドできるのはメンバ関数だけで、 TJS ではメンバ変数はオーバ 
ーライドできません。子クラスで親クラスと同じ名前のメンバ変数を作ると、 
親クラスのメンバ変数と子クラスのメンバ変数が同じものとして扱われ、 「super」 
を使ってもアクセスできなくなるので、注意が必要です。 
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KAG がどのよ 


吉里吉里/ KAG の構造と動作 
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.ジ 


:うな構造になっていて、どのような動作をするかについて、概 
要をお話しします。 


System フォルダのファイル 


KAG の System フォルダにあるファイルは、以下のようになっています 


LineBreak.asd 

行末クリック待ち記号用アニメーション定義ファイル。 

PageBreak.asd 

ページ末クリック待ち記号用アニメーション定義ファイル。 

check.png 

チェック•ボックスのチェック記号 （ 「 CheckBoxLayer . tjs 」 で使用)〇 

LineBreak.png 

行末クリック待ち記号用画像。 

LineBreak 一 a.png 

行末クリック待ち記号用アニメーション • セル画像。 

PageBreak.png 

ページ末クリック待ち記号用画像。 

PageBreak 一 apng 

ページ末クリック待ち記号用アニメーション • セル画像。 

... .... ..へ... 

. 

AnfmationLayer.tjs 

11111111 

アニメーションの進行を管理するコンダクタ用クラス 
rAnimationConductorJ とともに、アニメーションを行なう機能を 
持ったレイヤのクラスである 「 AnimationLayer 」 を定義する。 

BGM.tjs 

BGM を管理するクラス BGM と、それに必要な諸クラスを定義する。 

ButtonLayer.tjs 

ボタンとして動作するレイヤ•クラス 「Button Layer 」 を定義する。 

Config.tjs 

KAG の設定ファイル。 

CheckBoxLayer.tjs 

チェック•ボックスとして動作するレイヤ•クラス 「 CheckBoxLayer 」 

を定義する。 

Conductor.tjs 

KAG のシナリオやアニメーションの進行を管理するための「コンダ 
クタ」の親クラス 「 BaseConductor 」 と、シナリオ管理用のコンダ 
クタ•クラス 「 Conductor 」 を定義する。 

''.'人.：：.. 

DefaultMover.tjs 

' . 

レイヤの自動移動の「動き」を管理するクラスである 「 LinearMover 」 

と 「 SplineMover 」 クラスを定義する （ move タグで使用 ） 〇 

EcfitLayer.tjs 

単一行エディット(文字入力欄)用レイヤクラス 「 EditLayer 」 を定義する。 

' 

GraphicLayer.tjs 

KAG の背景レイヤや前景レイヤの親クラスである 「 GraphicLayer 」 

と、背景レイヤ用クラスである 「 BaseLayer 」、 前景レイヤ用クラス 
である「 CharacterLayer 」 を定義する。 

HistoryLayer.tjs 

メッセージ履歴レイヤ用クラスを定義する。 

tnitlalize.tjs 

システムの初期化を行なうプログラム。 「 start 叩 . tjs 」 はこのファイ 
ルを実行するだけのものである。 

KAGLayer.tjs 

KAG で用いられているレイヤクラスすベての親クラスである 「 KAGLayer 」 

を定義する。 

MainWindow.tjs 

KAG のウィンドウを管理するクラスである 「 KAGWindow 」 を定義 
する。 KAG の動作の多くがここに記述されている。 

Menuttjs 

メニュー項目の定義を行なう。 

MessageLayer.tjs 

KAG のメッセージ.レイヤを管理するクラス「 MessageLayer 」 を 
定義する。 
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Movle.tjs 

動画再生を管理するクラス 「 Movie 」 を定義する。 

Plugin . t|s 

KAG 用プラグインの親クラスである 「 KAGPIugin 」 を定義する。 

SE.tjs 

効果音を管理するクラス rSESoundBufferJ を定義する。 

ypia ^ OporiS §. t)s 

rConfig . tjsJ を古し、バージヨンのものから引き継ぐためのプログラム 0 

Utirt.tjs 

いくつかのユーティリティ関数を定義する(乱数発生、漢数字変換など）。 

YesNoDialog.tjs 

「はい」「いいえ」をユーザに選ばせるためのクラス 「 YesNoDialog - 
WindowJ とそれを使うための関数を定義する。 


ィベント駆動型 


「吉里吉里」でプログラミングをするときには、「イベント駆動型」という 
プログラミングの仕方をする必要があります。イベント駆動型のプログラム 
は、普段は待ち状態にあります。そこで「キーが押された」だとか、「タイマ 
一の時間切れが来た」だとか、「マウスが動いた」など、いろいろな「イベン 
卜」が発生します。それに反応する形でいろいろと動作の記述を行うのが「イ 
ベント駆動型」と呼ばれるものです。このようにイベントに反応して動作する 
プログラムの部分のことを、「イベント•ハンドラ」と呼びます。 


*イベント駆動 
イベントドリブン 
(event driven) とも呼ば 
れる 


「イベント駆動型」に対する言葉として、「手続き型」という言葉がありま 
す。手続き型ではプログラムをあらかじめ決められた手続きに従って、頭から 
順に実行します。 KAG のシナリオは、手続き型のプログラムです。 


イベント駆動型のプログラミングにはデメリットとメリットがあります。イ 
ベント駆動型のプログラムは、たとえば GUI のアプリケーションのように 「0 K 
ボタンが押された」や「メニュー項目が選択された」など、多種多様なイベン 
卜が発生する可能性のあるプログラムの記述に向いています。しかし、とくに 
「何かを待つ」という動作の記述が煩雑になりやすいというデメリットもあり 
ます。 

KAG のシナリオ • ファイルのように、機能を次々と順を追って実行するよ 
うな用途では手続き型が適していますが、 KAG のシステムそのもののように、 
GUI を構築する用途としてはイベント駆動型が適しています。 


KAG のシステムは、 KAG のシナリオ.ファイルに記述された手続き型のシ 
ナリオを実行するシステムであり、それ自体はイベント駆動型で記述されてい 
るというわけです。 
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KAG の構造と動作 



KAG の初期化の過程は 「 Initialize . tjs 」 に書いてあります。 「 Initialize . tjs 」 の 
実行が終わると制御は「吉里吉里」に戻り、「吉里吉里」は次のイベントが発 
生するまで待ちます。何かイベントが発生すれば、「吉里吉里」は TJS で記述 
されたイベント応答の関数である「イベント•ハンドラ」を呼び出します。 

「 Initializers 」 の実行が終わると、次のイベントが発生するまで待つ…と 
いっても、実際はすぐに 「 firstks 」 の実行が始まるので不思議に思うかもしれ 


ません。実はこれは、 「 Initializers 」 を実行し終えた直後、最初のシナリオの 
開始を告げるイベントが KAG 内部で発生するため、 「 first . ks 」 がすぐに実行さ 
れているように見えるのです。 


イベント•八ンドラ 


イベントに反応して記述される関数、それがイベント•ハンドラです。ウィ 
ンドウやレイヤなど、「吉里吉里」が提供するクラスにはよく 「 on 」 から始ま 
るメンバ関数があります。これらがイベント•ハンドラです。通常はこれを継 
承したクラスでオーバーライドすることでイベント.ハンドラを記述します。ど 
のようなイベント•ハンドラが記述できるのか、「吉里吉里2リファレンス」 
の「クラスリファレンス」を参照してみてください。 


* 筆者注 

" action " メソツドを 
呼び出すタイプのイべ 
ントの処理の方法もあ 
ります。 


たとえば、「 Menus . tjs 」 には「 Menultem 」 クラスを継承した「 KAGMenu - 
Item 」 というクラスが定義されています。このクラスはウインドウ上部に並ん 
でいるメニュー項目を管理するクラスですが、このメンバ関数に、 


function onClick() 


{ 


super. onClick ( • 

•); 

click ()； 


} 



というのがあります。これが「イベント•ハンドラ」です。この 「 onClick 」 
というのは、 メニュー 項目がクリックされたときに呼び出されるイベント•ハ 
ンドラです。ここでは 「 clickO ;」 として、同じクラスのメンバ関数である click 
を呼んでいます。また、イベント•ハンドラでは通常このように親クラスの同 
名のメソッドを呼び出します。 

KAG の System フォルダにある TJS スクリプトを見ても、よくこの on から始 
まる関数が使われているのが分かると思います。 


，2フ8 





15-2 


吉里吉里/ KAG の機能のアクセス 




宙里音里/ KAG の機能のアクセス 



TJS から KAG の機能に直接アクセスすることができます。 KAG で記述でき 
る範囲のことは KAG のシナリオで記述し、それで物足りなくなったら TJS で 
「吉里吉里」や KAG 内部の機能に直接アクセスできる、というのは、「吉里吉 
里/ KAG 」 の大きな特徴です。 


Hnitialize.tjsJ と 『KAGWindowJ 


「 Initializers 」 は KAG の初期化を行なうプログラムです。ほかの各スクリ 
ブトの読み込みや二重起動の防止のほか、 「 f 」 や 「 sf 」 などの KAG 変数ァク 
セス用の変数の定義も行なっています。 

その中で変数 「 kag 」 にクラス 「 KAGWindow 」 から作ったオブジェクトを 
入れている場所を見付けてみてください。 


/* 

KAG メインウインドウの作成 


var kag ； 

kag = new KAGWindow (); 


ここですね。この変数 kag は、 KAG のウインドウ（普段私たちがゲームなど 
の作品と接しているあのウインドウ）そのものです。 

この 「 KAGWindow 」 というクラスには KAG の動作のほとんどが定義され 
ていて、多くの KAG の管理するオブジェクト、たとえば背景や前景レイヤ、 
メッセージ.レイヤ、 BGM や効果音用のオブジェクト——などもこの変数 
kag からアクセスできることになります。 

変数 kag に入っているのはひな形となるクラス 「 KAGWindow 」 そのもので 
はなくて、クラスから作られたオブジェクトであることに注意してください。 

「 KAGWindow 」 には 「 process 」 というメンバ関数があります。これは 
KAG のシナリオの実行を開始するための関数です。 「 Initializers 」 の最後で 
は、 ' 
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/* 

first. ks の実 ft 
V 

kag.process ( M rirst.ks M )； 

となっていて、メンバ関数 「 process 」 を呼んでいます。ここから 「 firstks 」 
の実行が始まるのです。 


ウインドウ 


「吉里吉里」は、 「 Window クラス」でウィンドウの機能を提供しています。 
「 KAG 」 では、 「 MainWindow . tjs 」 で 「 KAGWindow 」 というクラスを、また 
「 YesNoDialog . tjs 」 で 「 YesNoDialogWindow 」 というクラスを定義しています。 

メイン•ウィンドウは、前述の 「 Initialize . tjs 」 で KAGWindow クラスから 
作られています。また、バージョン情報ダイアログも同じ KAGWindow クラス 
のオブジェクトです。 


レイヤ 


「 Layer クラス」でレイヤの機能を提供しています。「レイヤ」はウインド 
ウ内に表示されるもので、何かウィンドウ内に表示しようと思ったら、必ずレ 
イヤを作る必要があります。 


• 背景レイヤ 

「背景レイヤ」は、以下の式でアクセスできます。 


kag . fore.base 

表画面の背景レイヤ 

kag . back.base 

裏画面の背景レイヤ 


背景レイヤは I GraphicLayer . tjs 」 で定義されている 「 BaseLayer 」 クラスの 
オブジェクトです。 

r 吉里吉里」のレイヤ管理はレイヤを親子関係で階層的に管理します。そ 
の階層のトップ、すべてのレイヤの親にあるのが、「プライマリ • レイヤ」と 
呼ばれるものです。 KAG の場合、「表背景レイヤ」が必ずプライマリ•レイヤ 
になります 0 

レイヤの階層は、 KAG のウィンドウをアクティブにして 「Shift + F 12」 を押 
すことでコンソールに一覧表示されるので見てみてください。 
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レイヤは 「 Layer クラス」から継承されています。たとえば Layer クラスに 
は、レイヤを色で塗りつぶす 「 fillRect 」 というメソッドがあります。 

これを使って表背景レイヤを真っ赤に塗りつぶすには、_ — 

_ kag.fore.base.fillRect(0, 0 , 640, 480, OxffOOOO) ;_ 

とします。各引数の説明は「吉里吉里2リファレンス」の丨 Layer クラス」の 
該当メソッドを参照してください。 


• 前景レイヤ 

「前景レイヤ」は、以下の式でアクセスできます。 


kag . fore . layers [ rt ] 

表画面の前景 n 番のレイヤ 

kag . backJayer ^[ n ] 

裏画面の前景 n 番のレイヤ 


たとえば、 「 kag . fore . layers [0]」 ならば「表画面の〇番の前景レイヤ」とい 
う意味になります。 

「前景レイヤ」は rGraphicLayer . tjsJ で定義されている 「 CharacterLayer 」 
クラスのオブジェクトです。この「 CharacterLayerJ クラスも Layer クラスか 
ら継承されているため、 Layer クラスの各メソッドが使えます。 

⑩メッセージ•レイヤ 

「メッセージ.レイヤ」は、以下の式でアクセスできます。 


kag , fore , messages [ n ] 

表画面の n 番のメツセージ•レイヤ 

kag . back . messages [ n ] 

裏画面の n 番のメツセージ • レイヤ 


たとえば、 [ kag . back . messages [0]] ならば「裏画面の0番のメッセージ. 
レイヤ」という意味になります。 

メッセージ. レイヤは「 MessageLayer . tjsJ で定義されている「 Message - 
LayerJ クラスのオブジェクトです。 


BGM と効果音 


「吉里吉里」は 「 Wave ( PCM )」「 MIDI 」「 CD - DA 」 のいずれかでサウンド 
を再生することができます。 KAG の場合は BGM にこれらの3つのうちのどれ 
か一つを選べます。効果音には Wave ( PCM ) のみ使ことができます。 
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「 BGM 」 や「効果音」には、以下の式でアクセスできます。 


kag.bgm 

BGM 

kag . se [ n ] 

n 番の効果音バッファ 


BGM を管理するクラス 「 BGM 」 は、 「 BGM . tjs 」 で定義されています。た 
とえば “ test . wav ” を BGM として再生させた t ゝ場合は、 
kag.bgm.play (% [ storage : "test.wav "]) ； 

で再生できます。 


「効果音」を管理するクラス 「 SESoundBuffer 」 は 「 SE . tjs 」 で定義されて 
います。たとえば “ test . wav ” を効果音として効果音ノ くッファ0番で再生した 
い場合は、 

kag.se[0].play (% [ storage : "test.wav"]); ] 

とします。 


タグ•八ンドラ 


TJS から KAG のタグの機能を呼び出した t ゝ場合はよくあります。 

KAG のタグの多くは「タグ•ハンドラ」という、各タグに応じた関数を呼 
び出すことでその機能を実現しています。 

タグ•ハンドラは 「 MainWindow . tjs 」 の最後のほうにあり、 「 getHandlers 」 
という関数内に、 

タグ名： function (elm) 

{ 

( ここに処理の内容） 

} incontextof this — _ 

という形式で書き連ねてあります。引数 「 elm 」 では、タグの属性が辞書配列 
になったものを受け取ります。 

「 getHandlers 」 はこれらタグ名とそれに対応する闋数の辞書配列を返すだ 
けの関数で、この関数の戻り値は変数 「 tagHandlers 」 に入れられます。つま 
り、 fkag . tagHandlersJ から関数を直接実行してやればよいのです。 
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たとえば、 

©image storage 二 hoge•jpg layer=base page=fore 


というタグと同様の機能を TJS から呼び出した t ゝ場合は、 


kag.tagHandlers.image( % l storage : 

"hoge.jpg" 

layer : 

"base", page : "fore "])； 




と記述します。「％[]」の中に、 


属性名：属性の値 _ 

という形式で属性をカンマで区切つて指定して渡すことで、属性名を名前と 
し、属性の値をそれに対応する値とした辞書配列を渡すことができます。 


* 筆者注 

% D 内に辞窨配列のメ 
ンバとなるものを記述 
して辞窨配列を作成す 
る方法を使います。 


TJS からタグ•ハンドラの機能を呼び出す場合、「何かを待つ」という種類 
のもの、たとえばトランジシヨンの終了を待つ 「wt タグ」や時間待ちをする 
「wait タグ」などは正常に呼び出すことができないので、注意が必要です。こ 
れらを待つには、これらの完了を知らせるイベントを何らかの方法で受け取る 
必要がありますが、難しくなります。 


KAG を TJS から操作するときの注意点 


KAG は「菜」に多くの情報を保存しますが、 KAG が菜に保存しないような 
情報を TJS 側から操作すると、その情報は菜に保存されません。 

たとえば、背景レイヤや前景レイヤでは「レイヤにどの画像が読み込まれて 
いるか」の情報しか菜に保存されません。なので、たとえばレイヤに直接何か 
を描画しても、その情報が菜に保存されないため、菜を読み込んだときにその 
ときの情報が復元されないことになります。この場合は、次の「菜を保存可能 
な ラベル」 を通過する前にそのレイヤに別の画像を読み込むなどして、 KAG 
が菜に保存できる情報のみの状態に戻しておく必要があります。 
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KAG の機能を簡単に拡張できるようにするため 
に、 KAG はプラグインを扱う機構をもっています。 
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KAG のプラグイン 



KAG は、 KAG 用プラグインを TJS で書くことができる機構をもっています。 
これにより、 KAG に簡単に機能を追加できるようになります。 


KAG のプラグインは、 「KAGPlugin クラス」からクラスを網承して作りま 
す。 KAG には「雪プラグイン」や「スタッフロール•プラグイン」などが付 
属していますが、それらのソースを見ても KAGPlugin から何らかのクラスが派 
生しているのが分かります。 


プラグインは、おおむね以下の構造を持っています。 


• KAGPlugin から派生したクラス本体 
• そのプラグインを KAG のシステムに登録する部分 
• プラグインを使用可能にするためのタグ(マクロ)の定義 


通常は 「first.ks」 （最初に実行されるシナリオ • ファイル)の最初でプラグイ 
ンのファイルを呼び出して使います。 


KAGPIugin のメンバ関数 


「KAGPIugin」 には、「吉里吉里」本体から呼び出されるいくつかの関数が 
あります。たとえば 「onRestore」 は、栗をたどるときに呼び出されるメンバ 
関数で、これをオーバーライドして処理を書けば、栗をたどるときに実行した 
い処理を書くことができます。 

以下に「吉里吉里」本体から呼び出される関数の説明をします。また、説 
明の中で、 KAG に付属している「雪プラグイン」である 「snow.ks」 の内容に 
ついても例として説明します。 


• finalize 

KAGPIugin クラスの finalize メンバ関数は、通常のクラスでの動作と同じく、 
オブジヱクトが無効化されるときに呼び出されます。プラグインが後述の 
「kag.addPlugin」 で KAG のシステムに追加されると、 KAG の終了時に 「final¬ 
ize」 が呼ばれるようになるので、ここに何か終了処理を書くことができます。 
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「雪プラグイン」では、作成したオブジヱクトを in validate 演算子で無効化 
しています。 


• onStore(f ， elm) 

onStore は菜を保存する際に呼ばれます。 KAG は「保存可能なラベル」 （ 「 I 」 
付きのラベル）で菜をいったん内部に保存するので、保存可能なラベルを通過 
するごとにこの関数が呼ばれることになります。 

引数 「 f 」 は、保存先の菜データを表わす辞書配列です。 KAG の菜が辞書配 
列なのは前に話したと思いますが、この 「 f 」 も辞書配列です。ここに何か辞 
書配列のメンバを作って情報を記録しておけば、 「 onRestore 」 で同じ情報を 
読み出すことができます。 

(なお、引数 「 elm 」 は、現バージョンでは使われていません）。 


たとえば、「雪プラグイン」では以下のような記述になっています。 


function onStore (f , elm) 

{ 

// 杲を保存するとき 

var die = f.snows = % []; 

die . init = timer ! == void ； 

die.foreVisible = foreVisible; 

die.backVisible = backVisible; 

die•snowCount = snows.count; 


rf.snows = %[] J の部分で、 「 f 」 に 「 snow 」 という名前のメンバを作ってい 
ます。そこに新しい辞書配列オブジヱクトを作っています。 KAG のシステム 
は、架のデータに辞書配列や配列が入っていると、その辞書配列や配列の中 
身も保存するので、このような書き方ができます。 


変数 「 die 」 にもその新しい辞書配列オブジェクトを入れています。「=」演 
算子はこのように続けて書くと、いちばん右側に書いたもの（この場合は％ []) 
をそれぞれに代入する、という動作をします。 

「 die 」 や 「 f . snow 」 の中身ですが、前に「参照」について話したとおり、 
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このようにすると 「 f . snows 」 と 「 die 」 は同じ辞書配列オブジェクトを参照す 
るようになります。 

関数の残りの部分では、その 「 die 」 にいろいろと情報を記録しています。 


• onStableStateChanged ( stable ) 

「 onStableStateChanged 」 は、「安定」あるいは「走行中」の状態が変わっ 
たときに呼ばれます。引数 「 stable 」 は「安定」のときに“真”、「走行中」の 
ときに“偽”になります。 


KAG は状態として大きく分けて、「安定」と「走行中」の2つの状態をもっ 
ています。 

「安定」とは、 「 s 」 あるいは「1」あるいは 「 p 」 タグで停止中の状態で、ユ 
ーザーは菜の保存やメッセージ履歴の閲覧などをすることができます。一方、 
「走行中」とは、それ以外の状態で、シナリオが実行中であることを示してい 
ます。 

これらの状態が切り替わるときにこのメンバ関数が呼び出されます。 

何か走行中ではやりたくないことがあるときにこの関数を書けば、その状態 
を知ることができます。 

なお、「雪プラグイン」ではこの関数を使っていません（記述は空です)。 


• onMess 3 geHiddenSt 3 teGh 3 nged ( hidderi ) 

「 onMessageHiddenStateChanged 」 は、メッセージ.レイヤが「メッセー 
ジを隠す」のメニュー項目などで隠されるときと、その状態から抜けるときに 
呼びされます。引数 hidden は、メッセージ.レイヤが隠されるときに“真”、 
再び現れるときに“偽”になります。 

これは、たとえばプラグインでレイヤを表示していて、それをメッセージと 
一緒に隠したいときなどに利用することができます。 

• onCopy し ayer ( toback ) 

「 onCopyLayer 」 は、 「 backlay 」 タグあるいは 「 forelay 」 タグが実行された 
とき、あるいはトランジシヨン終了時に、裏画面の情報を表画面にコピーする 
必要があるときに呼ばれます。弓 I 数 「 toback 」 は、「表—裏」のコピーのとき 
に“真”、「裏—表」のコピーのときに“偽”になります。 

KAG のトランジシヨンの動作はかなりややこしいので後述します。 
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function onCopyLayer (toback) 

{ 

// レイヤの表——裏情報のコピー 

// このプラグインではコピーすべき情報は表示 • 非表示の情報だけ 

if (toback) 

{ 

// 表-^裏 

backVisib 丄 e 二 foreVisiDle; 

} 

else 

{ 

// 裏-^表 

foreVisible = backVisible ； 

} 

resetVisibleState(); 


メンバ関数 「 foreVisible 」 と 「 backVisible 」 はそれぞれ、「表画面の雪粒」 
あるいは「裏画面の雪粒」が表示状態であるかどうかを表わしています。雪プ 
ラグインは雪粒を表示するためのレイヤを、表背景レイヤと裏背景レイヤそれ 
ぞれを親にして、表画面と裏画面両方に作りますが、それぞれの可視•不可 
視の情報をもっているのがこれらのメンバ変数です。 

「 toback 」 が“真”の場合は 「backVisible = foreVisible 」 、“偽”の場合は 
「 foreVisible = backVisible 」 を実行します。「 resetVisibleState 」 メンバ関数は、 
rforeVisibleJ および 「 backVisible 」 変数の内容を実際に各雪粒のレイヤの表 
示状態に反映させるメンバ関数です。 


• onExchangeForeBackO 

「 onExchangeForeBack 」 は、トランジションの終了によって、裏画面と面 
画面の情報を入れ替える必要があるときに呼ばれます。 

トランジションの動作については後述しますが、このメソッドが呼ばれる時 
点でレイヤのツリー構造は、表画面と裏画面が入れ替わっています。 
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「雪プラグイン」では以下のように記述されています。 


function onExchangeForeBack () 


//裏と表の管理情報を交換 


var snowcount = snows.count ； 


Tor(var i = 0; i < snowcount ； i++) 


snows[i].exchangeForeBack ()； 

/ / move メソッド 

} 

を呼び出す 


ここでは、各雪粒を管理するオブジェクト （ SnowGrain クラスのオブジェク 
卜）の 「 exchangeForeBack 」 メンバ関数を呼んでいます。 SnowGrain クラス 
の 「 exchangeForeBack 」 は以下のような記述になっています。 


function exchangeForeBack () 

{ 

//表と裏の管理情報を交換する 
var tmp = fore ； 
fore = DacK ； 

.back = tmp ； 


「 fore 」 は表画面に表示されている雪粒のレイヤ、 「 back 」 は裏画面に表示 
されている雪粒のレイヤです。それを交換しています。 

トランジションの終了時には裏画面と面画面がそっくり入れ替わっているの 
ですから、このようにレイヤの情報も交換しないと、たとえば、いままで表画 
面に表示されていたと思っていた雪粒が実は裏画面に表示されていることにな 
っていた、ということになってしまいます。 


• onSaveSystemVariablesQ 

「 onSaveSystemVariables 」 は、システム変数に情報を確実に保存するため 
のタイミングを提供します。システム変数は、 KAG が終了し、再び起動して 
も同じ情報を保っている変数で、何かシステムに関わるような(菜とは独立し 
た)情報を記録しておくのに便利です。 

この関数内で 「 kag . scflags 」 に何かメンバを作り、そこに情報を記録してお 
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くことができます。 「 kag . scflags 」 は辞書配列オブジヱクトです。 
「雪プラグイン」にはこの関数はありません。 


■ プラグインの登録 


プラグイン.クラスを作ったら、そのオブジェクトを作って KAG のシステムに登 
録しなくてはなりません。登録するには、 「 kag . addPlugin 」 メンバ関数を使います。 

「雪プラグイン」では以下のようになっています。 

kag. addPlugin ( global . snow_object = new SnowPlugin (kag ))； 

// プラグインオブジェクトを作成し、登録する_ _ 

「 global . snow_object = new SnowPlugin ( kag ) 」として SnowPlugin クラスの 
オブジェクトを作り、グローノマル•オブジェクトのメンバ 「 snow _ object 」 に 
入れています（このように書くと、 「 global 」 に 「 snow _ object 」 というメンバ 
が自動的に作られてからオブジェクトへの参照が代入されます)。 

「 global . snow_object = new SnowPlugin ( kag )」 という部分式が 
「 kag . addPlugin 」 への引数になっていますが、「=」演算子それ自体は左辺（こ 
の場合は 「new SnowPlugin ( kag ) J ) を返すのでこの引数には新しく作った才 
ブジェクトが渡ることになります。 

この一行を複数行で書くと、以下のようになります。グローバル位置で宣言 
した変数はグローバル.オブジェクトのメンバになることに注意してください。 

var snow_object = new SnowPlugin(kag )； 

kag.addPlugin(snow_object )； 

プラグイン • オブジヱクトは二度以上登録してはなりません。二度以上登録 
しないために、「雪プラグイン」では TJS スクリプトを定義する iscript タグを、 
以下のような if タグで囲っています。 


ypeof ( global . snow_ob 3 ect) == undefined 
「 typeof ( global . snow — object )」 は、グローバル•オブジェクトの snow_object 
メンバが表わしている型を表わす式ですが、グローバル.オブジヱクトに 
fsnow _ objectJ が無ければ “ undefined ” になるので、それを利用して、すでに 


_ _ _參參⑩眷 
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グローバル.オブジェクトに snow _ objec びンバがあるかどうかを確認しています。 

iscript タグ内では最後のほうで snow_object メンバを作って値を入れている 
ため、何度実行してもこの iscript タグは1回限りの実行となります。 


マクロの登録 


プラグインを KAG から便利に使うため、「雪プラグイン」ではマクロをいく 
つか定義しています。定義は以下のようになっています。 


；マクロ登録 

©macro name="snowinit" 

@eval exp= n sn 〇 w—ob]ect•init (丄 7, mp)" 

@endmacro 

©macro name= u snowuninit" 

@eva 丄 exp="snow_object.uninit()" 

@endmacro 

©macro name="snowopt" 

@eval exp="snow_object.setOptions(mp)" 

@endmacro 

マクロの中に eval タグが入っているのに注目してください。 eval タグは exp 
属性で指定された TJS 式を実行するタグです。 

たとえば snowopt マクロでは以下の TJS 式を実行しています。 


snow—ob 〕 ect.setOptions(mp) 


ここで 「 mp 」 はマクロに渡された属性が入った辞書配列を表します。 
たとえば snowopt タグを以下のように使うと、 
alse forevisible 二 true 


「 mp 」 が参照している辞書配列のメンバ 「 backvisible 」 は “ false ”、「 fore - 
visible 」 は “ true ” になります。 

「 snow _ object 」 は SnowPlugin クラスから作られたオブジェクトで、「 setOp - 
tions 」 メンノマ関数にこの辞書配列を渡していることになります。 

このように、プラグイン • オブジヱクトへは簡単にマクロの属性を渡すこと 
ができます。 
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16-2 吉里吉里/ KAG のトランジシヨンの動作 

吉里吉里/ KAG のトランジシ3ンの鼸作じ 
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プラグインでなにかレイヤを作って使うときに、 KAG のトランジシヨンの動 
作につ I ゝて知っておかなければなりません。 

「吉里吉里/ KAG 」 のトランジシヨンの動作はかなりややこしいです。ここ 
では、 trans タグで、「 layer=base children = truej 、つまり背景レイヤとその子レ 
イヤも含めたレイヤに対してトランジションを行なう場合につ I ゝて説明します。 


まず、 KAG のレイヤの構造ですが、表画面は「表背景レイヤ」を、裏画面 
は「裏背景レイヤ」を頂点とした「親子関係」（階層構造)となっています。 

トランジシヨンの動作は、表画面に表示されている内容が、裏画面に表示 
されている内容に、時間をかけて切り替わる、ということですね。最終的に、 
表画面と裏画面の内容は両方とも、「トランジシヨン前に裏画面だったもの」 
の内容になります。 

トランジシヨン中で、切り替わっている間に、レイヤの構造はどうなってい 
るのかというと、表示の状態は変化しているとはいえ、実は構造には変わりは 
ありません。いまだ表画面は表画面、裏画面は裏画面のままです。 

構造に変化が起こるのは、トランジシヨンが終了する瞬間です。トランジシ 
ヨンが終了した時点では画面はまるっきり裏画面の状態になっているのですか 
ら、レイヤの構造的にも裏画面にしなければなりません。 


「吉里吉里/ KAG 」 はこのとき、以下の動作をします。 


① 「吉里吉里」は、表背景レイヤとその子レイヤたち、それと裏背景レイヤ 
と子レイヤたちを、そっくりそのまま、入れ替える 

② 「吉里吉里」は、トランジション前に表背景レイヤだったレイヤの、 onTran 
sitionCompleted イベントのイベント•ハンドラを呼ぶ 

③ KAG は、 r onTransitionCompleted J イベント.ハンドラの中で、裏画面だ 
ったレイヤの情報を、表画面だったレイヤの情報にコピーする 

(これにより表画面と裏画面が同じ状態になる） 

④ KAG は、裏画面と面画面の管理情報を入れ替える 


最初にも「表背景レイヤとその子レイヤたち、それと裏背景レイヤと子レイ 
ヤたちを、そっくりそのまま、入れ替える」とありますが、最後にも「裏画面 
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と面画面の管理情報を入れ替える」とありますね。これは、①のタイミングで 
「吉里吉里」本体は裏画面と面画面を入れ替えますが、それだけだと「本体は 
入れ替えたと思っているが、 KAG 側は入れ替えたと思ってない」という妙な 
状態になってしまいます。 

いままで裏画面のレイヤ • オブジェクトを参照していた KAG 内の変数が、吉 
里吉里側がレイヤの構造を入れ替えたため、実は表画面のレイヤ.オブジェク 
卜を参照するようになってしまった、という状態を避けるために、つまり、「吉 
里吉里」本体のもっているレイヤ構造の状態と合わせるために、④のタイミン 
グで KAG 側でも処理が必要なのです。 


プラグインでレイヤを表示管理する場合もこのルールに従う必要があります。 
プラグイン側にはこのために2つの関数、「 onCopyLayer 」 と「 onExchange - 
ForeBackJ が提供されています。「 onCopyLayerJ は3番のタイミングで、 
「 onExchangeForeBack 」 は4番のタイミングで呼ばれる関数です。 


「 onCopyLayer 」 は forelay タグや backlay タグでも呼ばれる関数ですが、卜 
ランジシヨンの終了時にも呼ばれる関数です。トランジシヨンの終了時におい 
てこの関数では、裏画面だったレイヤの情報を表画面だったレイヤの方にコピ 
一しなければなりません。これは 「 onExchangeForeBack 」 よりも先に呼ばれ 
るので、注意が必要です。 

つまり、 「 onExchangeForeBack 」 で表画面と裏画面の管理情報を入れ替え 
るのですが、それよりも前に呼ばれるということは、「吉里吉里本体のもって 
いるレイヤ構造の情報と、 KAG ある t ゝはプラグインのもっているレイヤ構造の 
状態が食い違っている状態」で呼ばれるということです。混乱を招くかもしれ 
ませんが、通常は、「雪プラグイン」で行なっているように、普通に状態のコ 
ピーを行なえば問題ありません。 

「 onExchangeForeBack 」 では表画面と裏画面のレイヤの管理情報を入れ 
替えなければなりません。これは、今まで裏画面のレイヤを参照していた変数 
•を表画面のものに、表画面のレイヤを参照していた変数を裏画面のものにそれ 
ぞれ入れ替えなければならないと言うことです。 

このように「吉里吉里/ KAG 」 のトランジシヨンの動作はかなりややこしい 
ものですが、「雪プラグイン」などを参考にしてみてください。 
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靨プラグインを改進する 


儀_ # # 


プラグインを作るといっても、すべてを何もない状態から書き上げるのは大 
変です。最初はプラグインの改造から入るのが適切ではないかと思います。 

ここではその最初の手引きとして、「雪プラグイン」を改造して「泡プラグ 
イン」を作ってみようと思います。 

雪は上から降るものですが、泡は下からわき上がってくるものなので、スク 
リブトの手直しがいくつか必要になります。 


名前の変更 


「泡プラグイン」を作るにあたって、いちばん動作が似ている「雪プラグイ 
ン」を改造するわけですが、「雪プラグイン」と同時に使いたい場合のことを 
考えて、名前の衝突が起こらないようにしなければなりません。 

まず、「雪プラグイン」のシナリオ•ファイルである 「 snow . ks 」 をコピーし 
ます。「泡プラグイン」なのでファイル名を 「 bubble . ks 」 にしましょう。 

bubble . ks 内にはいくつも 「 snow 」 や「雪」などの名前が使われています 
が、これを 「 bubble 」 や「泡」に変換してしまいましょう。お使いのエディタ 
の「置き換え」機能で以下の名前を一括して変換します。 TJS はアルファべッ 
卜の大文字と小文字を厳しく区別することに注意してください。「置き換え」を 
行なうときは、大文字と小文字を区別するような動作をさせる必要があります。 


変更前 

変更後 

雪 

泡 

snow 

bubble 

Snow 

Bubble 


このままだと「泡をふらせるプラグイン」のような妙な表現がコメント内に 
出てきてしまいます。気になる方は書き換えてください。 
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下から出現するように 


下から出現させるための変更が必要です。 


* 筆者注 

「吉里吉里」の座標系は、 
数学等で用いられてい 
る座標系と異なり、通 
常左上を原点とした、 
右方向および下方向が 
正方向の座標系です。 

* 筆者注 

実際には表画面の粒 
も裏画面の粒も同じ大き 
さなので r - fore . height ] 
は r - back.heightj でも 
問題ありません。 


まず、泡を出現させている場所を見てみましよう。 BubbleGrain クラスのメ 
ンバ関数である 「spawn」 です。 


function spawn () 


1 

// 出現 



1= Math.random() * window.primaryLayer.width ； 



// 横初期位置 


t = - fore, height; // 縦初期位置 


spawned = true; 



fore.setPos(1, 

t); 


back.setPos(1, 

t )； // 裏画面の位置も同じに 


fore.visible = 

owner.roreVisinle ； 

} 

back.visible = 

owner.backVisib 丄 e ; 


ここの「//縦初期位置」というコメントの付いている行に注目してくださ 
い。変数 fore は表画面の泡粒のレイヤ•オブジヱクトを参照しています。同 
様に変数 back は裏画面のものです。変数 t は粒のレイヤの y 座標(垂直方向座 
標）における上端位置を表わす変数ですが、「雪プラグイン」の場合は「- 
fore . height 」、 つまり表画面の雪粒のレイヤ • オブジヱクトの高さを負にした 
ものを代入しています。これにより、初期位置は完全に画面外でありながら、 
画面のすぐ上となっていたのです。つまり、画面外からすぐに画面内に入って 
こられる位置にしているということですね（横位置はランダムになります)。 


.296 
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TJS 


_參馨_⑩_ < 



泡の場合は下からわき上がるのですから、ここを変更しな ければ なりませ 
ん。 画面外で あり、 すぐに画面内に入ってこられる位置と いうと、 画面のすぐ 
下になります。 

上端位置が画面の縦幅と同じであればそのような状態になるはずですから、 

ししを、 

t = window.primaryLayer.height; // 縦初期位置 
にします。 rwindow . primaryLayerJ はウィンドウのプライマリ.レイヤ、つま 
り KAG の場合は背景レイヤですので、その 「 height 」 （縦幅）プロパティはす 
なわち画面の縦幅になります。 



泡粒の出現位置 
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上に向かうように 


移動方向を上方向にしなければなりません。 

BubbleGrain クラスのコンストラクタ （BubbleGrain メンバ関数） で 「 yvelo 」 
という、 y 方向(垂直方向）の速度を決定している部分があります。以下の部分 
です。 


yvelo = n*0. 6 + 1 . 9 + Math.random() * 0.2 ;//縦方向速度 


これの符号をまるっきり逆にしましよう。以下のようになります。 


yvelo = - （ n*0.6 + 1.9 + Math. random () *0.2 )； / / 縦方向速度 


画面外に出た場合の処理 


雪粒の場合は、雪粒が画面の下を超えれば、雪粒を上の位置に戻して再び 
降らせていました。その動作を行なっている箇所は BubbleGrain クラスのメン 
バ関数である move 内にあります。 


IT ( t >= window.primaryLayer. neight) 

{ 

t = -fore.height ； 

1=Math.random() * window.primaryLayer.width ； 

} 

ここの部分です。この if 文の条件式は、[雪プラグイン」では以下のように 
なっています。 


t >= window.primaryLayer.height 


変数 「 t 」、 すなわち粒のレイヤの上端位置を表わす変数の値が、 「 window . pri - 
maryLayer . heightJ つまり画面の縦幅を超えたら、という意味になります。 

泡の場合は、画面の上端を超えたら、という意味にしなければならないの 
で、条件式は以下のようにしなければなりません。 
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t <= -fore.height | I 


すぐに思いつくのは 「 t <0」 だと思いますが、上端位置が「0」、つまり画面 
最上部よりも上になっただけではレイヤ全体が画面外に出たことにならないの 
で 、 「t <= - fore.heightj となります。 

if 文のブロックの中で変数 「 t 」 に値を代入していますが、これは前述した関 
数 「 spawn 」 内と同じにする必要があります。 

この if 文は、最終的には以下のようになります。 


iT(t <= -fore.height) 

{ 

t = window. pnmaryLayer . height ; 

1=Math.random() * window.primaryLayer.width; 


1 ■ 泡粒の画像 1 

「雪プラグイン」で使う 

「雪粒」の画像は以下の 5 つです。 

1 snow_0 . png 」 「 snow_ 
1 snow_4.png 」 

_1 •png 」 「 snow_2.png 」 「 snow_3•png 」 


これと同じように、泡の画像として以下の 5 つを作ります。 
「 bubble — 〇 .png 」 「 bubble_l•png 」 「 bubble_2•png 」 
「 bubb±e_3.png 」 「 bubble_4.png 」 ioubDle—5.png 」 


完成 


これで改造は終わりです。マクロは 「 bubbleinit 」 と 「 bubbleuninit 」 と 
「 bubbleopt 」 の3つが定義されますが、使い方は「雪プラグイン」と同じで 
す 0 


回 
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■ジ • レイヤー/文字関連 


甲メッセージ•レイヤーに文字を数段に渡って表示したら、縦列がきれいに揃わない。| 

feu デフォルトにプロポーショナル•フォントを使うと勝手に字詰めが行なわれ、結果 
として縦列が崩れます。 Config.tjs 内のデフォルト.フォント指定を「プロポーシ； 
ョナル」から「等幅」フォントに変更してください。 

一般的なアドベンチャー•ゲームのメッセージ*レイヤーを、ゲームの途中でサウ 
ンドノべルのように画面全体に広げ、その後、また元の大きさに戻したい。 

メッセージ•レイヤーのサイズをシナリオ内で恣意的に変えるには [position] タグを用います。 


• AVG 風表示の例_ 

[position left=40 top=400 width=540 height=60]¥ 


•ノベル風表示の例__ 

[position left=40 top=40 width=540 height=400]¥ 


•全画面表示 

[position left=0 top=0 width=640 height=480]¥ 


® メッセージ • レイヤーに文字を書いたあと、トランジシヨンで背景画像を切り替え 
たところ、すでに害いた文字が消えてしまう。背景だげ入れ替えて、文字はそのま 
ま続けて窨きたい0 

トランジシヨンを行なう前に [backlay] タグを入れれば、すでに書いた文字が裏画 
| 面にコピーされ、それをトランジシヨンで表画面に呼び出すことができます。ちな； 
! みに、 [backlay] タグを効果的に利用するには、レイヤーとページの概念を充分に| 
| 理解することが必要になります。 ^ 

S r 吉里吉里 2/KAG3J の 「KAG2 互換モード i で、文末に [p] を付けたのに改ペー 
ジしてくれない〇 __ __ . ' '' ， ) 

A) [p] タグは改ページの「クリック待ち」を行なうだけで、 r 改ページ」までは行ない！ 
ません。 [p] タグの次に [cm] [er] [ct] のいずれかのメッセージ.レイヤー消去タグ丨 
I を置けば、すでに書かれた文字がクリアされます。 
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〇 メッ脅》ジメレイヤーに 文字を表示させたところ、文末に改 ページマークが街てじ 
まう。互換モードではタグ行末に¥を付けると改ページマークが出なくなったが、 
KAG 3 モードでは [ position ] タグを使う以外に何か方法はないだろうか？ _ 

® [ style ] タグの autoreturn 属性を 「 false 」 にすれ行されなくなります。 

0 選択肢のあるシナリオを香いてから画面をトランジシヨンさせたとき、元の画面の 
選択肢が見えないのに選べてしまう。 _ 

® [ locklink ] タグを使って選択肢を「選択不可」にすれば回避できます。 

©前景レイヤーやメッセージ • レイヤーなどに [ layopt ] タグを使おうとしたら「バリ 
アント型を変換できません」というエラーが出る。_ 

この エラーは [image] タグにおいて 「 layer 」 や 「 page 」 属性が指定されていない場| 
I 合や、属性が指定されていても書き方が間違っている場合に表示されます。また、| 

操作するレイヤーが存在していないことも考えられます。この場合、 [laycount] 夕| 
1 グで指定のレイヤーを生成すれば回避できます。 


自分で作った作品の画面が妙に暗い〇 

為 J メッセージ • レイヤーがデフオルトの状態になっていることが考えられます。 con -] 
fig . tjs 内のメッセージ • レイヤーの色と不透明度を変更するか、 [ position ] タグを； 
使ってください。 


// ♦ メッセージレイヤの色と不透明度 

// frameColor には OxRRGGBB 形式で （RR GG BB はそれぞれ 2 桁の 
//16 進数）メッセージレイヤの色を指定します。 frameOpacity には 0 
// 〜 255 の数値で、不透明度を指定します。メッセージ枠用の画像が指定 
// されている場合は無効です。 

； frameColor = 0x000000 ； // position タグの color 属性に相当 
； frameOpacity =128; // position タグの opacity 属性に相当 
t ここの frameOpacity を0にする。 

I または、下記の一行をスクリプトの先頭に加える。 

[position 丄 ayer=message0 page=back frame:"" opacity=0] ¥ 
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(p Config . tjs 内で設定した基本フォントを、途中で 「 Conrfig . qs 」 を書き直して変更 
したのに、変更が反映されない。 _ 

fej —度でも「吉里吉里 / K AG 」 を動かした場合、 「 Confif . tjs 」 内で設定されたフォン H 
は savedata フォルダ内のセーブ•ファイルにシステム変数として記録されているから 
です。 savedata フォルダ内の全ファイルを削除して再度動作させれば反映されます 。 i 

©文字入力画面を、ダイアログではなく、インターネットの掲示板に見られるような 
枠つきの入カボックスにしたい。 __ 

[£) [ edit ] タグによる単一行エディットを使います。 I 


P 文字を縦書きにしたい。 

[jD system フォルダにある 「 Config . tjs 」 の、以下の部分を変更します。 


/ / ♦ 縦書きモード 

// メッセージレイヤを標準で縦書きモードにする場合は false ではなく 
// true を指定してください。 

； vertical = true; // position タクの vertical 属性にネ目当 


またはシナリオ • ファイル内に以下のように記述します。 


[position vertical=true] ¥ 


P メッセージ•レイヤーのサイズを変更した後、初期値にリセットしたい。 

UJ メッセージ . レイヤーの属性を 「 position 」 で変更した後、初期設定 （ Config . tjs で 
設定したもの）に戻したい時は、再度 [ position ] タグで指定する必要があります。 
リセットするタグはありません。 


間タグを使って選択肢を表示すると、場合によっては空行が出てしまう。 

み ] [if] [link] 〜 [endlink] [r] [endif]¥ 

上のように記述した場合、改行も条件分岐の中に含まれます0条件が“真”の場合は選択 
肢（〜の部分）が表示されて改行され条件が“偽”の場合は改行ごと無視されます。 
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[®「 kag . historyLayer . clearO 」 で初期化できます。 KAG シナリオ内から実行する場合 
は r [ evalexp = M kag . historyLayer . clearO n ]¥ j の一行を記述すれば、その時点でメッ 
セージ履歴が何も書かれていな t ゝ状態に戻ります。 


また深をたどったときにメッセ履歴を常にクリアした、のであれ! f > rMainWindow . tjs_M 
の「 functionintemalRestoreFlags ( f,clear = true,elm = void )」 の最後(バージョンによっ I 


ても若干異なりますが、1283行付近)に fhistoryLayer . clear 〇; J という一行を加えます。 



_ 文字入カダイアログに入力した文字を、次に入力するときに消したい。 〕 


S ダイアログを表示する前に、 [ eval ] タグを用いて以下のように変数に空文字列を入 
れておけば、何も文字が入力さ tin 、ナ 、状態でダイアログが表示されます。 



B— 1 ら ^ ——— 

I [link exp="kag. close ()"] ゲー厶を終了する [endlink] 
j [link exp= "kag. shutdown ()••] ゲームを ; 公 [endlink] 

| 前者は終了の確認ダイアログが出るのに対して、後者は確認ダイアログが出ません。 


シナリオを 終了するときはどんなタグを打てばよいか。 


9シナリオ.ファイルで何も書かれていないところまでくれば、「吉里吉里」はそこ 
で自動的に停止します。 [S] タグを記述してもそこでシナリオの実行は停止します。 
「吉里吉里」自体を終了したければ [ close ] タグを使い、最初に戻りたいのであれば 
[ jump ] タグや [ gotostart ] タグを使います。 
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FAQ 

_ 


トランジシヨン/アニメーシヨン/画像関連 


0 KAG 3 に付属の雪ブラクインを使って画面に雪を降らせ、デバックでシナ リ オの再読み 
込みをしたり、開始したラベル以外のラベルからロードすると、雪が止まら IK ® 
る。また、雪ブラグインをロードしようとするとエラーが出る。 ^^ 

S) 古い KAG3 では、雪プラグインを複数回ロードした場合、上記のような現象が起き 
ることがあります。また、 KAG3 の 「ver.3.04」 以降では、雪プラグインを2回以丨 
上ロードしようとするとエラーが出るようになりました。雪プラグインや雨プラグ| 
イン、スタッフロール•プラグインは 「first.ks」 の先頭などで一度だけ呼び出すよ丨 
! うにしてください。 


® mp 赖拡張子のビデオ♦ファイ施を再生ようとしたらエラーが出て再生できない、 
また、タグが_視されるのだが？ 

(S mpeg 形式のビデオファイルを再生する場合はファイルの拡張子まで指定してくだ： 
さい。また、 「krkr.eXe」 と同じ場所に 「krmovie.dll」 をコピーする必要がありま| 

Iす。 | 


E スクリプトを実行中に「二つのレイヤのサイズは同じでなければなりません」とい 
う エラー が 出る。 _ ノ 

[k) 背景レイヤーに読み込む画像は画面サイズと同じでなければなりません。また、卜： 
ランジシヨン前の画像とトランジシヨン後の画像サイズも同じでなければなりませ 
I ん。該当の画像ファイルを画像処理ソフトでリサイズすれば回避できます。 

® クリッカブル • マップの領域画像ファイル（末尾がのファイル）が上手く 
作れない0 

[kj Photoshop やペインターなどのフルカラー対応ソフトではなく、 「D-Pixed」 （フリーソ 
{ フト）のような256色専用の画像処理ソフトを使ったほうが簡単です。 

0クロスフェードなどのトランジシヨンを行なったとき、画面にチラツキが発生して 

—しまう0 _ / 

(5) 設定ユーティリティである krkrconf.exe を起動して、「画像演算の分割処^^:する/しな 
い」と「垂直同期を待つ」を調整すれ避できる場合があります。 ! 
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0 画像を表示させようとしたときに「〜について適切な拡張子を持ったファイルを見 
つけられませんでした」のようなエラーが出る。 

fey 指定のファイルが存在しないか、または見付からないことが考えられるので、ファ丨 
イル名を確認するか、また、ファイル名を r n 叫（半角ダブル.クオーテーション）| 

! でく くって指定してください。 ^ ] 

〇ルール•ファイルを自作してユニバーサル • トランジシヨンに使ったところ、意図 
したトランジシヨンが行なわれない0 ___ __ 

ノレ-ル•ファイルがグレースケールで保存されていな t 、可能性があります。 f 


6 F トランジシヨンを行なったところ、その少し前にトランジシ-ンで表示させた國像 
や文字が改めて表示されでしまう0 _ _ _ 

圓 トランジションを行なう前に [ backlay ] タグを書き忘れている可能性があります。1 


P 画が酿されない0 ノ ■ ] 

「 first . ks 」 の先頭行に 「@ loadpluginmodule = krmovie . dll 」 を入れてください。この 
とき、 krkr . eXe と同じ場所に、 krmovie . dll をコピーする必要があります。この場 
合、再生する直前に r @ evalexp = M WaveSoundBuffer . freeDirectSoundO M J の1行を記 
述すると、不具合が低減されることがあります。 


0文字は不透明なままで、自分で作ったメッセージ•ウインドウを半透明にするに 

—. 1 ^* 0 _ — — „ _ _ _ _ _ _ _ : — ___> 

S タグで制御するのではなく、 メッセージ枠用の画像を半透明の状態で作っておきま| 
す。《チャンネル付きの PNG をグラフイック•ソフトに出力させるのが手っ取り I 
早いです。 | 


® Ffash < Dswf 利用畤に、フラッシュ特有の右クリック•ポップアップ• メニ3—を 
—禁止したい。_一 _ ノ 

® できません。 
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背景、メッセージ • レイヤー、立ち絵を同時に消したい。 

0 

m 

そのようなタグはありません。 base レイヤーには黒い画像を読み込み、それ以外の; 
レイヤーには不可視状態を指定してトランジションさせれば同時に消えます。 


[image storage 二" kuro•]pg" layer=base page=back]¥ 

L 丄 ayopt layer=message0 page=back visible=false]¥ 

[layopt layer=0 page=back visible=false]¥ 

[trans meth 〇 d=crossfade time=100]¥ 

[wt]¥ 



_ 640 X 480 の画像が作れない。 

A ) これは画像処理ソフトの使い方の問題ですが、画像処理ソフトで拡大縮小したと 
きにぴったり 640 X 480 にならない場合は、リサイズを行なって、余分な部分を切 
り落とすしかありません。_ 

_前景レイヤーの左上に黑い四角が出る0 ___ _ 

| S 何もデータをロー ドしていない前景レイヤーにはダミーとして 32 X 32 の黒い四角が 
I 表示されます。 何 か画像をロードすれば消えます。 


OggVorbis / MP 3/ 音声関連 


P MP 3 フアイ/レの再生ができない。 

|^|吉里吉里2ならびに KAG 3 において、 MP 3 は夕版の時点でサポートを打ち切ってい| 
ます。 OggVorbis という代替手段があるので、そちらをご利用ください。 J 

0 KAGSystem リフアレンスの通りに音楽 CD ( CD - DA ) を指定しても、コンソール 
⑽「指寫された K ライブでは CD-DA を再生できません」というエラー•メッセー 
ジが出て CD が再生されない。_ _ — 一 _ 

㈤ CD のドライブが re :」 でないことが考えられます。もし CD ドライブに、 「 fd や丨 
rq：J などの別のドライブレターを与えている場合は、スクリプト内の re :」 をその j 
I ドライブレターに書き換えれば動作します。 
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_ • 

® Wave ファイルの BGM や効果音が途切れ途切れに再生されたり、再生中につつか 

しえるような現象が起こるのだが？ _；_ ノ 

「吉里吉里2」に同梱されている 「 krkrconf * exe 」 あるいは 「 userconf * exe 」 を起動| 

} して、 「 DierctSound 」 周りのオプションを変えてみてください。 

^ OggVorbis による BGM や効果音が再生されないのだが？ 

指定のプラグインをシナリオ先頭部などでロー ドしているか確認してください。プ| 
ラグインがロードされていないと、 OggVorbis 形式のファイルは利用できません。| 


起動/動作/バージョンアップ関連 


吉里吉里」の動作が急に重くなったり、マウスが動かなくなったりする。 

® ウイルス活動を常時監視するソフトウヱアの中には、アプリケー ショ ンの動作を極 
端に遅くするものもあります。これをはじめ、できるだけ多くの常駐ソフトをタス丨 
クトレイから外してください。 

® KAG で書いたシまリオを「苦里吉里」で動かしたら、毎回シナリオが first.ks から 
始まって■まう0 _ — „ 

( S 「 first . ks 」 内で [ jump ] タグを使って別のファイルへ飛べばよいかと。 

® 作成したゲームを CD-R に焼いて実行すると、終了しようとしたときと菜を挟もう 
とした時にエラーが出るのだが？ CD-R の中身を ハードディスクに コピーして実 
行してもエラーが出るのだが？ _ 

(AJ CD-R 上から実行すると、吉里吉里が生成した システム • データを 書き込めずに エ 
ラーが出ます。 「 Config . tjs 」 の中身で菜を使わないように指定すれば回避できる 場 
合があります。また、 ハードディスクにコピーした だけでは CD-R 上の読み取り属; 
性が解除されないので、同様にエラーになります。ファイルの読み取り属性を解除 
するようにしてください。 
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fDr 吉里吉里」の紹介用ブロジェクト 「 syokai 」 を起動しようとすると、エラーが出 
て起動できない0 _ _ _ 

A ) 「吉里吉里」の紹介用プロジェクト 「 syokai 」 は、 KAG の template フォルダにある 
システムや 「 KAG 3 plugin 」 にあるスクリプトなどを使うようになっているため、 
KAG のフォルダ構成を変更した場合は動作しません。 KAG 3 の圧縮ファイルを展 
開した直後に見られるフオルダ構造を維持して t ゝれば、動作します。 


© 吉里吉里/ KAG を起動したとき、「〜は XP 3 アーカイブではないか、対応できない 
形式です」というエラーが出て起動できないのだが？ _ — _____ 

( 5 ) 吉里吉里/ KAG でプロジヱクトを起動する時に指定するのはプロジヱクト.フォル i 
ダであって、個々のシナリオ•ファイルではありません。フォルダを指定してください 。I 



( J ) firstks の冒頭などに拡張子まで含めて記述します。 
[mappfont storage :" font • tft "] ¥ 


起動時にフルスクリーンにしたい。 I 

IS 手っ取り早い方法は、フルスクリーンの状態の時に終了させ、そのときの丨 
「 datasc . kdt 」（[ datasc . ksdj の名前かも知れません）をセーブ.データとして一緒| 
に配布します。 「 datasc . kdt 」 や r datasc . ksdj には、前回フルスクリーンだったか| 
I どうかの情報などが書き込まれています。 


^ 画面がウンともスンとも言わなくなってしまう。フリーズしたわけではないのだが。 

|^U SHIFT キーと F 4 キーを同時に押してコンソールを表示させてください。コンソールの最 
下部のメッセージを読むと、「非表示になっているメッセージ•レイヤーの裏ページなど 
でクリック待ちになっている」場合があります。これはトランジシヨンのミスなど 
でよく発生します。コンソールに書かれたメッセージに従って対処してください。 


—#310 























^罾や爾ブラグインが利用できなぃ。 

[£) 雪/雨プラグインのシナリオ • ファイルと画像ファイルを自分のプロジェクト•フ！ 
ォルダにコピーし忘れてぃる可能性があります。 

®「 [link exp="kag.restoreBookMark(0, false)"][emb exp 二 " kag. い 

cretBookMarkPageName (0) " ] Jendlink] _ _ 

と書きます。 「 restoreBookMark 」 と 「 storeBookMark 」 は第二引数でダイアログ 
を出すかどうか判断しますが、これらはデフォルト設定では 「 true 」 になってぃます。！ 

S ) 画像データの場合、画質を落としてもかまわなぃならば、 「 PNG 」「 TLG 」「 ERI」i 
ではなく JPEG を使うとサイズを軽減できます。音声の場合は、無圧縮 wav を使う 
よりは rOggVorbisJ などを使うとサイズを軽減できる場合があります。また、 
Releaser で出力する実行 （ exe 形式）ファイルは zip と同じ圧縮方法を使ってぃる 
ため、 zip 程度の圧縮しかかけることができません。もっと圧縮をかけたぃ場合は、 
Releaser の設定で「圧縮」に分類されてぃるファイルはすべて「無圧縮」に分類 
し、配布するときに cab など圧縮率の高ぃアーカイバで圧縮し直すとよぃでしょ 5 
う。 UPX よりも cab のほうが圧縮率が高ぃです。 


その他/素朴な疑問 


0シナリオ • ファイルは大きすぎると処理的に辛いと聞くが、一つのシナリオ • ファ 

[^1 一つのシナリオ • ファイルが 200 KB を超えるようなら、分けたほうがよいでしょ 
う。ちなみに、処理的に辛いと言ってもそう問題になるほどではないので、あまり 
気にする必要はありません。最近のバージョンではむしろ他のシナリオ•ファイル 
にジャンプするときに時間がかかる場合があります。とは言っても、こちらもそう 
問題になるほどではありません。 


「吉里吉里 J はノベルゲームやアドベンチャ—ゲームに特化したエンジンなのか。 

違います。 ノベル ゲームに特化しているのは、「吉里吉里」ではなくて 「 KAG 」 の 
ほうです。「吉里吉里」はアプリケーションやゲームのエンジンで、それを ノベル 
やアドベンチャー•ゲームの専用エンジンとして動作させるのが、 「 KAG 」 です。 
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I画像の一部を消去する 


何かの画像を読み込んだレイヤーに対し、矩形で指定した任意の部分の画 
像を消去（透明処理）できますが、 TJS でレイヤーに直接描画する必要があり 
ます。 「 face = dfBoth 」 にして、 Layer クラスのメンバ関数である 「 colorRect 」 
の不透明度の引数に負の数を指定すると、対象の矩形領域から不透明度が取 
り除かれます。この場合は色の引数は無視されます。 


■クリッカブル • マップで力ーソルの口ール • オーバー時に画像を変える 


領域アクション定義ファイルで 「 onenter 」 を使うとよいと思います。 

1: onenter="kag.fore.layers[0]. 丄 oadlmages(%[storage : 'map1.png 
「領域1」にカーソルが来たとき、表画面の「前景レイヤー0」に 「 mapl . png 」 
を読み込んでいます。ちなみに [ button ] タグで対応できるような内容であれば、 
button タグを使ったほうが楽です。画像ファイルに 「 map . png 」 を用意し、そ 
れとは別に、変えたい画像ファイルを 「 mapl . png 」 などで用意します。 


籲シナ U 才例 

*start 

@layopt layer=0 page=fore visible=true 
; t 前景レイヤー 0 を表示 

@ layopt layer=messageO page=fore visible 二 false 
; t 邪魔なので消去 

@image layer=base page=fore visible=true storage=map 

@s 

*ml 

@layopt 丄 ayer=messageO page=fore visible=true 
領域 1 をクリック 
@s 
*m2 

@layopt layer=messageO page 二 fore visible 二 true 
領域 2 をクリック 
@s 
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fmap.maj の内容は以下のようになります0 


1 

onenter="kag.fore.layers[0]•loadlmages(%[storage ： 'mapl.png '])"； 

stor age ="first.ks "； target 二 "* ml"; 

2 

nenter="kag•fore.layers[0]• 10 adlmages( % [storage:'map2.png '])"； 

stoage="first.ks "； target="*m2 "； 


前景立ち絵の“口ぱく”を効率よく行ないたい 


「セリフをしゃべりはじめた」ときにアニメーション.ファイルの付属して 
いる画像を [image] タグでロードし、「セリフをしゃべり終わった」ときにアニ 
メーションしていない静止画像をロー ドすれば、効率的です。 


レイヤー上に簡単な図形を書きたい 


TJS2 を用いれば可能ですが、実用的な速度は出ません。 

@eval exp="kag.fore.base.colorRect(10, 20, 100, 100, 

—OxffOOOO, 128) n __ 

上の記述の意味は「表背景レイヤの （10,20)- (109, 119) を赤、不透明度50% 
で塗りつぶす」になります。吉里吉里本体に矩形と点や変形以外の描画を行 
なう機能を追加する予定は今のところありません。 


■画像の階調変更 


階調の反転は image タグの 「rceil」「gceil」「bceil」 にそれぞれ「0」を、 
r rfloorj rgfloorj「bfloor」 にそれぞれ「255」を指定することによって可能に 
なります。その他、値を調整すればセピア調への変換などもできます。 


r 吉里吉里 j の起動画面を黒から白にする 


「Initialize.tjs」 というファイルの末尾にある 「KAG.process( n first.ks n );」 と 
いう部分を 「KAG.process("first.ks n ,,,true);」 に書き換えてください。 

また、 Config.tjs 内の下記の部分を「 ;initialMessageLayerVisible = false;」 と 
します。その後、 「first.ks」 （最初に実行されるシナリオ•ファイル）の先頭 
行で表背景レイヤーに白Vゝ画像を読み込むように記述します。 

このとき初期状態ではメッセージ.レイヤーが表示された状態になっている 
ので、「表メッセージ•レイヤー0」も非表示にしたほうがよいでしょう。その 
後、 [wait] で少しウヱイトをとって、確実に画面が表示されるようにします。 
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• #«### 癱シナリオ例 __ 

[image stORage="white" page=fORe layer=base]¥ 
[layopt layer=messageO page=fORe visible=false]¥ 
[wait time=100]¥ 


[ S ] タグのみ停止させる仕様 


未読既読とは無関係に、単に「次の選択肢まで進む」仕様にできます。つ 
まり、 [ s] タグでのみ停止する仕様ですが、これは以下のようにすれば実現で 
きます0 _ _ — 

① 「Config.tjs」 の 「autoRecordPageShowing」 を 「false」 に設定0 

② さらに [wb] タグの属性を「 canskip=truej にする。 


■買い物画面での買い物制限 


買い物などの画面で持ち金が足りなくなるとリンクを無効にし、品物を買え 
なくするようなシナリオは、下記のように記述します。 

•シナリオ例 

，•変数を初期花 

[eval exp="f.a=0 , f.b=0,f.money=2000"] 

，•代金を決める 

[eval exp="f•ia=80,f•ib=1000"] 

★loop 

[er] 

[nowait] 

卵 [emb exp=f • a] 個 / [emb exp=f . ia] R 

[if exp="f.money [if exp="f.money>=f.ia"][link 

target=*plusa] 購入 [endlink] [endif ] [r] 

エプロン [emb exp=f .b] 個 / [emb exp=f.ib] 円 

[if exp="f.money [if exp="f.money> = f.ib"][link 

target=*plusb] 購入 [endlink] [endif] [r] 

残金 [emb exp=f • money ] 円 
[endnowait] 

[s] 

*plusa 
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[eval exp="f.a=f.a+ 1"] 

[eval exp="f.money 二 f.money-f.ia"] 
[jump target=*loop] 

*plusb 

[eval exp="f.b= f.b+1"] 

[eval exp="f.money=f.money-f.ib"] 
[jump target=*loopJ 


入力文字の制限 


単一行エディット （ EditLayer . tjs ) に「ひらがな」と「 • 」と「一」のみ入 
力させ、それ以外の文字が入力されたら弾く場合は、文字コードをチヱックし 
て下記のように書くことができます。272 行目 （関数 「 onKeyPress 」） の、 


—if (#key 一 >= 32) _ 

となっているのを、以下のように書き換えます。 


if(key > 

= ' ¥x3 040 1 ScSc key ぐ 

='¥x309f ' || key = 二 

i 參 1 

II 

key == ' ■ 






リンクや選択肢への自動フォーカス 


複数の選択肢を表示させ、指定した選択肢に自動的にカーソルを フォー カ 
スすることができます。選択肢を表示した直後に 「 @eval exp = M kag . fore . base . 
cursorX = 40, kag . tore . base . cursor^T = 40, kag . current . keyLink = O n 」 と書き、選 
択肢のある場所までカーソルを移動させ、 kag . current . keyLink = の部分でリン 
ク番号を指定します。 

ちなみに、リンク番号は1番目のリンクが「0」、次からは「1」「2」「3」と 
なります。 


リンクや選択肢用矩形の調節 


リンクを選択したときに出る半透明の矩形の長さを調節するには、 [ link ] と 
[ endlink ] の間に [ locate ] タグを使います。 


❿シナリオ例 

l_sty 丄 e autoreturn= raise] 

[link] ほ tf ら [ locate x=0][locate x=580] [endlink] [r] 
[link] ほげらラね [locate x=0] [locate x=580] [endlink] [r] 








______ 


TIPS 

鬱 

[ link ] ほげらうねら [locate x =0] [locate x =580] [ endlink ] [ r ] 
[style aut 〇 return = true ] 

[ locate ] タグのあとの半角 スペースを それぞれ忘れないように。 


■選択肢のランダム表示 


あめだまを 

A . 綾里姉にあげる 

B . 吉里ちゃんにあげる 

C . Dee ちゃんにあげる 

というのを、選択肢のアルファベットの部分はそのままで、選択内容だけを毎 
回ランダムに入れ替えて表示させたい場合、以下のように2次元配列や「入 
れ替え」演算子を使うとスマートに書けます。 


•シナリオ例 

@eval exp=" f . data = [[• 綾里姉にあげる 1 , 1 ジャンプ先ファイル名 . ks 1 , 
•★ ジャンプ先ラベル A •] , [• 吉里ちゃんにあげる | ,'ジャンプ先ファイル 

名 . ks' , '* ジャンプ先ラベル B • ] , [ 'Dee ちゃんにあげる 1 , ' ジャンプ先フ 

ァイル名 .ks', ジャンプ先ラベル C']]" 

@eval exp="f.tmp = intrANDom(0,2), f.data[0] f.data[f.tmp]" 

@eval exp 二 " f.tmp = intrANDom(0,2), f.data[1] f.data[f.tmp]" 

@eval exp="f.tmp = intrANDom(0,2), f.data[2] f.data[f.tmp]" 

A . [link targe t= " [0] [ 2 ] " s t 〇 Rage= " [ 0 ][1]"][emb 

exp="f.data[0] [0] "] [endlink] 

B ■ [link target="[1][2 ] " stORage="[1][1]"][emb 

exp="f.data[l][0] " ] [endlink] 

C ■ [link target= " [ 2 ] [ 2 ] " s tORage= " [ 2 ][1]"][emb 

exp="f.data[2] [0] " ] [endlink] 

1 行目で、「選択肢として表示する文字列」、「ジャンプ先のシナリオ•ファ 
イル」、そして「ジャンプ先ラベル」を定義しています。中央の3行で、1行目 
で定義した内容を乱数を使ってシャッフルしています。単純に個々の乱数から 
結果を得るわけではないので、重複はありません。最後の3行で、シャッフル 
された内容を選択肢として表示します。 
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■ BGM のランダム再生 


前述の TIPS 「選択肢のランダム表示」を応用し、選択肢を表示する代わり 
に PLAYBGM を実行するように指定すれは可能です。 


•シナ U 才例 


@eval exp="f.myBGM 

'bgm3.mid']" 

= ['bgml.mid 

, ' bgm2.mid 1 , 

@eval exp="f.tmp = 

f.myBGM[f.tmp]" 

intrandom(0,2), 

f.myBGM[0] 

< - > 

@eval exp="f.tmp = 

f•myBGM[f.tmp]" 

intrandom(0,2), 

f.myBGM[1] 

< - > 

@eval exp="f.tmp = 

f.myBGM[f.tmp]" 

intrandom(0,2), 

f.myBGM[2] 

< - > 


リンクの ツール 



「[ linkhint ="&， 1行目 ¥n 2行目” 1 ]ヒントヒント [ endlink ]」 のように、 「 hint =」 
に続けて「”&リと 「 n M で囲んでヒントを書くことができます。途中で 「¥ n 」 
を記述すると、そこで改行させることができます。 


一度入力した名前をそのまま使う 


2回目以降のプレイ、または一度名前を入力した場合に、最初に定義され 
ているサンプル文字をプレイヤーが入力した名前に入れ替えることができます。 
名前を格納する変数を、ゲーム変数 n f . name " ではなく、システム変数" sf . name 11 
にすれば'可能です。 


■ラベル名を乱数から生成する 


以下のように記述します。 

[eva 丄 exp=" f .ikisaki='* number ' +mtrandom (1,3)"] 

イコールの右側では乱数によって得られた 1 から 3 の数字と 「* number 」 と 
いうラベル名（文字列扱い）を結合し、それぞれ 「* numberl 」「* number 2」 
「* number 3」 というラベル名を生成しています。 

それを rf . ikisaki 」 という変数 ( こ代入しているので、「 [ jumptarget = ?, & f . ikisa - 
ki f , ]¥ j と書けば、 「 f . ikisaki 」 という変数内のラベル名が「&」によって [ jump ] 
タグの target 属性に引き継がれます。 











■ m 鳋發聲免 当然、 「* numberl 」「* number 2」「* number 3」 というラベルがシナリオ内 


に存在しなければなりません。 


■ラベル名を変数で指定する 


乱数だけでなく、一般の変数も、同じようにラベル名に利用することができます。 


_シナ IJ 才例 

[input name=f.name] ¥ 

[eval exp="f.ikisaki= 1 *'+f.name"] 

[jump target="&f.ikisaki"]¥ 

*minako 

[er]¥ 

みなこ [s] 

*emi 

[er]¥ 

えみ [s] 

*ai 

[er]¥ 

ぁぃ [si _ 一 一 

ただし、この例だと、準備されていない文字を入力された場合に飛び先のラ 
ベルが存在しないため、エラーになります。 


■[ move ] タグの path 属性に変数を用いる 


「 path 」 は、「カンマ」「空白」「(と)」のいずれかで区切られた数値の列を 
受け付けるので、 


@eval 

exp="f.x 〒 400, f. 

y=400, 

f.0=255" 


@move 

layer=0 spline: 

=false 

page=fore delay=0 

time=1000 

path=" 

&f.x+','+f.y+',' 

+ f • o" 




などのように、カンマで区切った変数を渡せます。 


■オリジナルマクロのパラメータを変数に代入する 


mp を用います。「 [macro name = piyo ] [eval exp = M f . test = mp . para ,f ] [ end - 
macro]¥j と定義し、シナリオ内で [piyo para = une ] と書けば f und という値が 
f.test に入ります。 
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0 詰め/空白詰め 


「 [emb exp = w %.2 f . sprintf ( f . tmp ) 11 ]¥ J のように記述します。 「％.2 f 」 は小数点以 
下2桁まで表示するという意味です。同様に、 


”％2 d " 

(2 桁に満たない場合は上位を空白詰め） 

"%3 cT * 

(3 桁に満たない場合は上位を空白詰め） 

••%03 d " 

(3 相 1 に満たない場合は上位を0詰め） 


のように書くことができます。 


I 入力文字列を数値として判定 


文字列を数値に変換するには「+」か 「 str 2 num 」 を使います。 「 f.number = 
+ f . numberj あるいは 「 f.number = str 2 num ( f . number )」 のように記述します 0 
「+」は半角しか受け付けませんが、 「 str 2 num 」 は入力された文字が全角でも 
強制的に数値へ変換します。 


■変数内容を含むセーブ • タイトル 


「 sf . name 2」 が登場人物の名前だとすると、 「* label !& f . name 2+ f の提案リの 
ように記述すれば、ラベルのセーブ•タイトルに変数の内容が代入されます。 


■変数内容の距離 


プレイヤーが入力した変数を r f . nmlJ とし、乱数によって得られた変数を 
f . nfl 〜 f . nf 3 としたとき、もっとも 「 f . nml 」 に近い変数を f . nfl 〜 f . nf 3 の中か 
ら選ぶには、次のようにシナリオに記述します。 


•シナ II 才例 

[eval exp="f.nc 11 =Math.abs(f.nml-f.nfl)"]¥ 
[eval exp="f.ncl2=Math.abs(f.nml-f.nf2)"]¥ 
[eval exp?f.nc13 二 Math.abs(f.nml-f.nf3)"]¥ 
[eval exp="f.nmin=Math.min(f.ncl1,f.ncl2)"]¥ 
[eval exp="f.nmin=Math.min(f.ncl3,f.nmin)"]¥ 
[if exp="f.nmin==f.ncll"]n f 1[endif]¥ 

[if exp="f.nmin==f.ncl2"] n f 2 [endif]¥ 

[if exp="f.nmin==f.ncl3"] n f 3 [endif]¥ 









付録 

■最初に起動された日から経過日数を求める 


シナリオの先頭などで | [eval exp = M sf.firstTime = (new DateO).getTimeO if 
sf.firstTime === void , f ]¥ j と書いておけば、システム変数の 「 firstTime 」 に初 
回起動時の日付と時刻が入ります。時間原点を「1970年1/1の午前0:00:00」 
とし、それからの経過ミリ秒を表わしているので、現在との差を取ることで時 
間差を計算します 。 「(new Date 0). getTime 0」 の部分で現在の時間原点から 
の経過ミリ秒を得ています。 


[eva 丄 exp= " f . passeclTime 二 (new Date ( ) ) . getTime () - 
sf . f irstTime" ] ¥, 

[eval exp="f.passedDates = 〜〜 （ f•passedTime / 

(60*60*24*1000)) ”] ¥ 

初回起動から [emb exp="f.passedDates"] 0 ¥_ 


上記の 3 行を記述することにより、初回起動時からの経過日数を求めること 
ができます。 


wait した時間を変数に代入する 


wait に入る直前に、変数に 「 System . getTickCountO 」 で得られる値を代入 
します。 

そのあと、リンクで飛んだ先でもう一度「 System . getTickCountOJ で値を 
得、その値から先ほどの値を減算すると二つの地点間の通過時間を得ること 
ができます。 


•シナ IJ 才例 

[link target=*s2] リノフ [endlink] 

[eval exp="f.start = System.getTickC 〇 unt()"]¥ 

[wait time=5000]¥ 

[s] 

*s2 

[eval exp?f.elapsed = System.getTickCountO - f.start"]¥ 
； この時点で f . elapsed に通過時間 
[emb exp="f.elapsed"]¥ 

[s] 
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wait 長を変数で指定したい 


エンティティを利用します。 

•シナリオ例 


[eval exp="f.a =1000 "][wait time="&f.a"] 
こんにちは 

m_ 

また、配列を使う方法もあります。 


•シナ IP 才例 

[eval exp="f.a =[]"][eval exp="f.a[1] =10"] 

[eval exp="f.a[2] =1000 "][eval exp="f.a[3] .=10000 "] 

[eval exp="f.b =1"][wait time="&f.a[f.b]"] 

こんにちは 

[ 1 ]_ _ 

こちらの場合は、 [ evalexp = ff f . b = l lf ] の「1」を「2」や「3」にすることに 
よってウェイトを変えることができます。 


■ 「待ち』のときに菜をいじらせない 


[ waitclick ] タグを使います。このタグが効いている場合は、菜の操作などは 
一切できません。 


■通常時とノーウェイト時で処理内容を変更する 


「[ ifexp =" kag . chSpeed != O n ] ノーゥヱイトのとき行なわない処理。 [ endif ]」 ま 
たは「 [ playsestorage = "再生するファイル n cond =" kag . chSpeed !=0"]」 と記述し 
ます。 

「 kag . chSpeed 」 というのは、文字表示速度です。 


■ ビデオ再生開始時の黒ノ V ックを表示しない 


映像の再生開始時に一瞬黒くなる状態を回避するには、再生開始時を見せ 
ないようにします。下記のように再生開始後わずかな時間だけ映像を非表示 
にしておけば黒バックを見えなくできます。 









付録 


纖 #め 


TIPS 


馨 

_ 


•シナリオ例 


[videoleft=0 top=0 width=640 height=480 visible=false]¥ 
[playvideo storage^"white.avi"]¥ 

[wait time=100]¥ 

[videoleft=0 top=0 width=640 height=480 visible=true]¥ 


■曲と画像の同期 


[ resetwait ] タグと [ waitmode = untiltime 二?????]を組み合わせて使います。 


•シナリオ例_ 

[playbgm storage^"xxxxxx"loop=false] ¥ 
Lresetwait]¥ 

； なんらかの処理 

[wait mode=until time 二 ？？？？] ¥ 

； t 曲再生開始（正確には resetwait タグの位置）から 
;????ミリ秒まで待つ 


■音と文字を同期させ、スキップ中は音声を再生させない 


自動的に読み進む場合に“真”になっている 「 kag . autoMode 」 を利用します。 

秦シナリオ例 

Lplayse storage=voice.wav cona="!kag.skipMode"] 

表示 メッセージです！ 

[ws cond="kag.autoMode"][1][stopse] 

自動読み進み状態の場合は [ ws ] タグで待ち、スキップ動作中は音声を再生 
しないように cond 属性を指定しています。 


■動画や音声データを CD から読み込む 


必要最小限の実行ファイルのみをハードデ V スクにインストールし、それ以外の画 
像や音声データを CD にアクセスして読み込みたい場合は、下記のようにします。 

要領は、「 Storages . searchCD 」 で返ってきたドライブ文字を、「 Initialize.tjsJ 
の 「 Storages . addAutoPath 」 の指定先に組み込むことです。 「 Storages . searchCD 」 
は、該当する CD が見付からなかった場合に空文字列を返します。 
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•シナリオ例 


*checkCD 

@eval exp=" f .CDdrive = Storages • searchCD (’GAME 一 CD ■) •• 

@if exp="f.CDdrive ==''" 

@cm 

[nowait] CD を ドライブに 挿入 してく ださい • • • [endnowait][1] 

@ jump target=*checkCD .： 

@enaif 

@eval exp="Storages.addAutoPath(f.CDdrive + ' : /data/')" 
@eval exp=" Storages . addAutoPath ( f . CDdrive + 1 •• /data/s 〇 me • 
xp3# 丨 ）" 

@s _ _ 


「 GAME _ CD 」 は CD のボリュー厶•ラベルです。 「 Storages . addAutoPath 」 
を使っている部分で CD の eg ディレクトリと 「 data / some . xp 3」 の中に自動検 
索パスを設定しています。自動検索パスを設定しておけば、ファイル名を指定 
すれば自動的に CD の中のファイルを参照するようになります。 


2つの XP 3 ファイル間でシナリオ • ファイルのジャンプ 


TJS スクリプトを変更すれば可能です。 「 Initialize . tjs 」 の 「 if ( Storages . isEx - 
istentStorage ( System.exePath + n patch . xp 3 M ))」 と書いてある行の前に、たとえ 
ば以下のように記述します。 

if(Storages.isExistentStorage(System.exePatn + 

"scenario.xp3")) 

{ 

Storages.addAutoPath(System.exePath + "scenario.xp3 #")； 


これで「吉里吉里」の実行可能ファイルと同じ場所に 「 scenario . xp 3」 が存 
在すれば、その中にあるファイルも読みに行くようになります。 
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#####_ 


TIPS 


■配布ファイルを分割する 


たとえば、 「 scenario . xp 3」 と 「 graphic . xp 3」 を作っている場合、 

Storages.addAutoPath(System.exePath + "scenario.xp3 #")； 

Sto rages.addAutoPath(System.exePath + "graphic.xp3 #")； _ 

のような行を、 「 Initialize . tjs 」 に「追加」する必要があります。 

場所は 「 Initializers 」 のどこでもよいですが、書く位置によってファイルの 
検索順が変わるので、同名のファイルが存在するときは注意が必要です。他 
の 「 Storages . addAutoPath 」 よりも後ろに書いたほうが検索で優先されるので、 
ir(Storages.lsExistentStorage(System.exePath + 

"patch.xp3")) 

という行の直前に追加することをお勧めします。 

必要に応じてこれらは追加してかまいませんが、このような記述だと、各 
xp 3 内直下のファイルしか検索されません。 xp 3 ファイルは内部でフォルダの 
階層構造をもてるようになっているので、 「 scenario . xp 3」 や 「 graphic . xp 3」 
を作るときは、 Releaser で指定するとき、その指定したフォルダ直下に必要な 
ファイルが存在するようにしなければなりません。必要ならば、 

Storages.addAutoPath(System.exePath + 

_"graphic.xp3#qraphics/");_ 

のようにアーカイブ内のその下の階層を指定することもできます。 

また、「 Storages . addAutoPath 」 には、「 System.exePath +」が必要になりま 
す。「吉里吉里」の実行可能ファイルと同じ場所にあるということを明示しな 
いと、トラブルが発生する可能性があります。 


I 複数のバッチを配布する 


初回公開時のファイルを 「 verl . O 」 として verl . l パッチを作り、公開した後 
に、 verl .2 パッチをリリースしたくなった場合には、 verl .2 パッチの内容に 
verl . l の変更点を包有しないでも verl . l から 1.2 への差分ファイルだけの配布が 
できます。 

KAG 3 の場合、 patch . xp 3 の次に patch 2. xp 3 patch 3. xp 3 patch 4. xp 3. と探 

していきます。なかった場合は、そこで探すのをやめます。このため、パッチ 
だけを随時追加していくことができます。 
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Warning! 注意） 

このページ以降に紹介されている作品は、 KAG 使いを目指して吉里吉里 
2/ KAG 3 を学習される皆さんのために、フリーソフト作者の方や同人サークル 
の人々が「参考までに」と本書への収録を許可してくださったものです。 

中には ソース （シナリオ • ファイル、 画像、音など）を全部または一部公 
開している作品もありますが、以下の利用規定に従ってご活用ください。遵 
守されない場合は著作権の侵害となります。 

① 本書に付属する CD - ROM 内に収録されているゲー厶 • 作品 • 素材について 
は、それぞれの作者または権利者が readme ファイルなどのドキュメントに 
明記している利用規定に従って利用してください。 

② 特に作者の明記がない場合、これらの一部または全部を不特定多数の人間 
が閲覧可能なネットワーク上に無許可でアッブロードしてはなりません。 
また、無許可で CD - ROM などのメディアに収録し再配布してはなりません。 

③ 画像、音響素材、映像などの素材をそのまま、または改変して自作品内に 
使用してはなりません。個人的な学習用途に利用する場合のみ自由に利用 
できます。 

④ シナリオ ks ファイルの内容をコピーしてそのまま自作品内に使用してはな 
りません。自作品に合わせて改変し、利用する場合は可です。収録された 
シナリオ ks ファイルの利用はあくまでも參考程度にとどめてください。 

⑤ この CD - ROM 内のデータを利用したことによって ユーザー が何かしらの損害 
を蒙った場合、本書の著者、本書の出版社、収録ソフトウェアの作者は何 
らその貴を負わないものとします。この条件に同意できなければデータの利 
用は認めないものとします。 

KAG 使いを目指して後に続く人々のためにも、ルールを守って気持ちよく 
利用されることをお願いいたします。 
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CD-ROM の内容について 
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CD _ ROM の内容について 


广 r r f J 
r r r r ! 

一 广 …… 厂 . ...— 疒， ……, 


▼収録データ • フォルダ 

吉里吉里ダウンロードサイトで公式に配布さ 
れている「吉里吉里2 SDKversion 2.18/ KAG 3 
version 3.18 revision 2」と、ルール•ファイル 
が30種類以上含まれたトランジシヨン，ライブ 
ラリが収録されています。 

利用規定については同梱のドキュメント•フ 
アイルの内容に従ってください。 


▼ KAG 講座フォルダ 

本書の KAG 講座で説明されている内容を用 
いたサンプル.プロジェクトが収録されていま 
す。これは本書内に掲載されているシナリオ例 
の大半をそのまま吉里吉里で動かせるようにし 
たものなので、本書を読みながら Step ごとにひ 
とつずつ実行してみることをお勧めします。 

なお、本プロジェクトはいくつかの吉里吉里 
プラグインを利用しています。このため吉里吉里を展開したときに得られる 
「 kr 2_218 r 2¥ kirikiri 2¥ plugin 」 内に含まれているすべてのプラグインを 
「 krkr . eXe 」 ど同じフォルダ内に配置しないと正常に動作しません。本プロジ 
ヱクトの利用規定については同梱のドキュメント.ファイルの内容に従ってく 
ださい。 


Q 取錄データ 
f-Q KAG 講座 
；-T .1 plug-in 

s - Q プ□ジ1外フォルダ形式 
! h-C] 1999xe1999 
= - 1"1 Canvas_Life_p 
j--f 1 showercall 
! i -- Q ド□ヌマン 
I l-Q 紫月 vol_0 
! L Gl 桃花扇サンプル版 
a - Q 実行形式 
j--Cl Collage 
[I--Q Foster 

j--j.1 PictualStory-twer 

j 白〇ガ'う M ) 中®少女 
| I scenario 

j . G ソウディアック r 120 
L -Q scenario 
! Lq 学校七不思議 
) hQ 最後の夏 
j L G 3 萝の終わり 
白索材 

L 。 〇 OggVorbisBGM.SE 


▼plug-in フォルダ 

TJS 編第 16 章で制作演習を行なった「泡のプラグイン」が含まれています。 
細かい利用規定については同梱のドキュメントファイルの内容に従ってください。 


▼ 『プロジェクト•フォルダ形式』フォルダ内の作品について 

6作のゲーム部サンプル版）が、作者の方々のご厚意によって公開直 
前の状態で収録されています。ダウンロー ドした吉里吉里を展開すると得られ 
る template フォルダと同じサブフォルダ構造を持っており、これをリリーサ ー 
で exe にまとめると公開用の実行形式ファイル(こなるので、リリーサーの使い 
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CD - ROM の内容について 


方を練習するときにも使えるでしょう。また、すべての素材やシナリオが丸見 
えなので、 ks ファイルの中身を読みながら動作を確認していくことによって 
KAG シナリオを書くときの参考になるかもしれませんが、画像や音響素材の 
利用は本書を購入された方の個人的な学習用途に対してのみ可能なので、注 
意してください。 

すべての作品はプロジェクト.フォルダを 「 krkr . eXe 」 にドロップすれば純 
粋に ゲーム （一部サンプル版）として遊ぶことができますが、これらの作品の 
ほとんどは特殊な処理を行なう上で KAG 講座と同様に吉里吉里プラグインを 
利用しているため、吉里吉里を展開したときに得られる 「 kr 2_218 r 2¥ kirikiri 2¥ 
plugin 」 内に含まれているすべてのプラグインを 「 krkr . eXe 」 と同じフォルダ 
内に配置する必要があります。これを行なわずに起動すると正常動作しないの 
で、ご注意ください。 

また、その他の細かい利用規定については、圧縮ファイルを解凍すると*得 
られる readme . txt またはそれに類するドキュメントをご覧ください。 


▼ 『実行形式フォルダ』内の作品について 

「吉里吉里 2/ KAG 3 J で制作された完成版の作品が8本収録されています。 
一般公開用と同様の圧縮形式（一部インストーラ形式）で収録してあるので、 
それぞれの作品を自分の PC にインストールするか、任意の場所に展開するな 
どしてお楽しみください。アニメーションや画像の移動、変数処理による謎解 
きやマルチエンディングなど、「吉里吉里 2/ KAG 3」 を使うとどのような作品 
が制作できるのか、その理解の手助けになると思います。 

なお、一部作品につ t ゝては作者の方のご厚意から ks ファイルのみ公開のお 
許しをいただきました。これらのサブフォルダには scenario フォルダが存在し、 
その中に KAG 3 シナリオの書かれた ks ファイルが圧縮状態で入っています。画 
像や音などの素材がないため実行はできませんが、読むだけでも勉強になるで 
しよう。 


▼ 『素材』フォルダ内のデータについて 

フリ ー素材として利用できる OggVorbis 形式の BGM をご提供 t 、ただきまし 
た。この素材 フォルダ 内のデータだけは取り扱いが異なり、皆さんがゲームを 
作る上で使えそうなシーンがあったらどんどん利用してもらって構いません。 
もちろん、作者の方の利用規定をきちんと守ってご利用いただく必要があるの 
で、収録されている readme . txt をご覧ください。 


####### 


* 》士 

それぞれの圧縮ファイ 
ルの展開について説明し 
ます。 

「KAG 講座」 「1999xe」 
「ドロ ヌマン」 「紫月」「桃 
花爾」 「ZODIAC」 の6作 
品は GCA 自己展開害庫形 
式なので、ダブル•クリ 
ックして展開先を指定す 
れば、そこに圧縮ファイ 
ルの中身が展開されます。 

「 CanvasLifeJ [FosterJ 
rPictualStory-twei-」 は 
インストーラ形式なので、 
インストーラの指示に従 
つて展開してください。 

fshowercallj 「ガラス 
の中の少女」「学校七不思 
謙」「最後の夏」「夢の終 
わり」は LZH 形式の圧縮 
ファイルなので、 LZH フ 
ァイルを展開でぎる圧縮 
解凍ソフトを利用して展 
開してください。 

プラグインの 
「bubble-zip」 と 「collage」 
は ZIP 形式の圧縮ファイ 
ルなので、 ZIP ファイルを 
展開できる圧縮解凍ソフ 
卜を利用して展開してく 
ださい。 
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ホラー•テキストアドベンチヤー ri 999 ChristmasEve [ ver . l .999 n]J 


「横浜かまいたちファンクラブ」 ( YKFC ) 

内にある「 1999 ChristmasEveProject 」 が、 

2000年の12月に公開したノベルタイプのテ 
キストアドベンチャーゲームです。 

ホラー系なので怖いものが苦手な方にはお 
勧めできませんが、「当時の KAG でどんなこ 
とができるのかをできるだけ数多く試す」と 
いう目的で、さまざまな表現形態に挑戦し 
た、実験的な作品となっています。 

現在ネット上で公開されている最新のノ <ージョンは「1.3」で、これは吉里吉里 / KAG 
の旧バージョンで制作されたものですが、本書には吉里吉里 2/ KAG 3 に移植した未 
公開の 「 Final (⑴1.999」バージョンが収録されています。バグ•フィックス 
は行ないましたが、一部誤動作することがあるかもしれません。予めご了承く 
ださい。なお、これは公開用完成版ではないので、再配布はご遠慮ください。 

演出の見所や KAG シナ U 才のワンポイント 

それほど大したことはしていないのですが、以下の機能を使っています。 

• 別ファイルによるマクロの集中管理 
• 制限時間つき選択肢 

• RPG 風戦闘画面の構築 
• 音楽と文字表示の同期 

• OggVorbis による BGM 
• 変数を利用した体力の表示とサフ チン 
• スタッフ ロールと エンデイン グリスト 
• 右クリックによる未読/既読判別機能 

「本格的な長編を作りたい」という理由で制作に入ったので、シナリオが長くなる 
ことは覚悟していました。このため、できるだけ読みやすい記述を心掛けました 
が、いかがでしょうか。 KAG 使いを目指す方々のご参考になれば嬉しいです。 

( 文：『横浜かまいたちフアンクラブ』代表 P 丨 A 少尉） 



http://www.piass.com/ykfc/ 
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l アル • ノベルゲーム [Canvas Life 前夜祭 DISC 』 


家族と家庭というものは、戦後になってそ 
の関係が著しく変容しつつあります。 

子供は親の所有物という父を家長とする古 
い家族関係の時代とは違い、最近良く耳に 
するのは「虐待」という言葉。子供の自我 
が成り立たない間、その個体が生命を維持 
するには親に依存しなければいけません。し 
かし、親が子供に依存してしまい、行き過ぎ 
た賴や性的搾取に t 、たる ことは珍しくな I 、です。 

「子供って何だ？」「家族って何だ？」そういうところからこのゲームは生 
まれました。尊敬されない父親、母であることを忘れる母親、感謝することを 

忘れた子供 . 今の時代、いろいろな大切なことが豊かさに隠されておざな 

りになってしまっています。大切な忘れ物を届けるために、このゲームは作り 
出されたのです。ライトな感覚でお楽しみください。 



演出©馬所や K AG シナ U 才のワンボイント 



この作品は「吉里吉里2 0 39」の時代に 
作られたものです。初めて吉里吉里で作っ 
た作品なので、かなり稚拙な内容になって 
いますが、「未読判定付きの CG 鑑賞モー 
ド」や「ロード画面」「音楽モード」や「ス 
タッフルーム」など、構造的には g 通りを 
網羅しているので、これから作ろうという 
方には参考になると思います。 

収録するに当たって、もともとの成人指定の内容を一般向けに改変し、 
「 ver 2.18」 に対応させています。ソースがめちゃくちゃ汚いのは申し訳ないで 
す。現在までに五本の成人指定 VNG をリリースしてますが、最新のは多少 
きれいなソースです。後は本当にベーシックな演出しかしていません。 

これから死ぬまで吉里吉里でモノを作り続けていくと思います。それだけ吉 
里吉里には魅力があります。 このツールは 表現する ことの 喜びをもたらしてく 
れました。みなさんにもそれが伝われば、作者冥利に尽きます。 


_( 文： 『 ICONOCLASM 』 主宰京秋人） 

http://www.alpha-net.ne.jp/users2/ryouot/ 
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ヴイジユアル • ノベルゲーム『シャワーコール j 


『現実』という単語を辞書で調 
ベてみましよう。そこには『頭の 
中で考えるだけのことではなく、現 
に実際こうであるという状態•事 
実』と書かれていると思います。 

でも、こんなことを考えたこと 
はありませんか？ 人生など、誰 
かが見ている『長い夢』の一部分 
にすぎないのではないか…。 

この作品の主人公は、ごく平凡 
な人間です。夢と現実とが交錯する中で、そんな主人公がどのように考え、行 
動するのか。ストーリーが進行するにつれて、微妙に変化する『現実』という 
単語の意味。そうしたものを、楽しんでいただければ幸いです。 


( 文 ： 『studio WALK 』 代表朝から炒飯） 
http://members.jcom.home.ne.jp/studio-walk/ 

v _/ 


演出の見所や KAG シナ U 才のワンポイント 


演出 • KAG シナリオともに、ご 
く平凡な構成になっていると思い 
ます。強いて見所を挙げるとすれ 
ば、土曜日•深夜のシナリオで作 
成した『雷鳴効果』だけかもしれ 
ません。 

ほぼ一年前に作成した KAG シナ 
リオを見てみると、何ともガサツ 
で幼稚なタグを書いていたのだと思 
わず赤面。 

サンプルとして皆様のお役に立つかどうか甚だ疑問ではあるのですが、この 
程度の知識でもノベルを製作できるということをご理解いただければ本望です。 


^•330 

















脱力系ブラックお笑いノベル『泥沼ヒーロー ドロヌマン』 


人がいるところで「助けて〜」と叫べ 
ば、たいてい誰かが手を差し伸べて助け 
てくれると思います。 

しかし、それで助かるとは限りません。 
事態が悪化するかもしれません。それば 
かりか、助けてほしいわけでもないのに、 
余計なことをしてくれるかもしれません。 
そんなヒ ーロー がいたとしたら . 



という感じで製作されたのが、このドロヌマンです。『泥沼ヒーロー』です 
から、もちろん何かすればするほど事態が悪化します。実際にいたとしたら、 
絶対に来てぼしくない、ハタ迷惑なヒーローの生き様を見てやってください。 


演出の見所や KAG シナ U 才のワンポイント 





本作はギャグ ノベル。 そのため、「テン 
ポよく」「事態が悪化する」ということを 
念頭に置いてネタを考えました。ある程度 
ネタが揃ったところで、それらを組み合わ 
せて全体の流れを決めます。 

この後に絵を描き始めるのですが、ここ 
で KAG でどのような演出ができるのかを知 


っていれば、具体的にどんな絵を描けばよ 
いかイメージしやすくなります。まずは簡単なものを作ってみることをオスス 
メします。私も初めての練習として、ドロヌマンを作りました。 

さて、全体の流れと見せ方が決まると、こんどはシステムをどうするかが決 


まります。プログラムに慣れている方ならば、いきなりマクロを組んで処理を 


効率化させることもできるとは思いますが、そうでない方はまず マクロ なんて 
考えずにシナリオを書いてみてください。そして少し作ったところで見直して 
みると、似たようなことを複数記述している部分があるでしょう。その部分を 
マクロで 統一すると、スクリプトが見やすく、書くのも簡単になります。です 
から、マクロは ぜひ マスター することをお勧めします（と 言いつつ、 私もさほ 
どマクロ 化できてるわけではないのですが。 （△ ' ;) 

あとはやる気と時間さえあれば、きっとあなたにもゲームが作れますよ！ 


( 文：『地球のあくび』 うにゆ〜） 

http://www.earthcape.ne.jp/users/unyu/ 
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女性向けノーマル恋愛アドベンチヤー『桃花扇 〜 Sample Version 〜 


フリーソフトとして配布予定の中華 
風アドベンチャーの体験版プラス a 。 

序盤の一週間がプレイできます。 

プレイヤーの分身となるヒロインは、 

桃花（名前変更可能）おてんぱ娘で口 
の達者な女の子です。 

攻略可能な男性キャラクターは全部 
で七人 。 Sample Version には、そのう 
ち二人が登場します。彼らとの好感度 
を高めていって ベス トエン ディ ングを迎えるのが、ゲームの主な目的です。 

体験版にシナリオを若干追加したため、半端なところで話が途切れていま 
す。続きの気になる方は、一度クリアすると出現するパスワードをホームペー 
ジまでお持ちください。 

瀵出の罵所や KAG シナ U 才のワンポイント 

いちばん苦心したのは 、 RPG 
風の戦闘シーンです ( Tdaily ¥ 
batol . ks 」。 未完成）メッセー 
ジ•レイヤーを position タグで 
体カゲージとして表示させ、敵 
に攻撃されるごとにゲージが減 
っていく仕組みになっていま 
す。 

朝ごとの日付表示は 「call — 
return 」 で呼ばれ、月や年が自 


立ち絵表示はマクロ化し、直前に表示された画像と比較して、同じなら卜 
ランジション時間を短縮します ( daily ¥ makuro _ trans . ks ) 〇 

まだまだ KAG の多彩な機能を使いこなせていませんが、皆様の参考になれ 
ば幸いです。 

( 文 ： 『SENA Project 』 — グロア） 
http://fairy.vis.ne.jp/project/ 
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動で進んで t 、きます ( daily ¥ date . ks ¥* date ) 〇 
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ホラー•アドベンチヤー 『紫 月』 Vol.O (サンプル版) 


「 IssisFactory 」 が「横浜かまいたちフ 
ァンクラブ」さんと共同で開発している学 
園ホラー•アドベンチャーです。 

完成はまだ先なのですが、 PIA 少尉殿の 
ご要望に従い、序章の部分の全ソースを 
KAG 3 シナリオも含めて素材の状態で提供 
させていただきました。序章のみのサンプ 
ル版のため、ゲームとして遊ぶには非常に 
短いですが、立ち絵と顔絵を使ったアドベンチャーゲーム風の画面レイアウト 
構築、右クリックによる現在位置表示の 他、 我々が目指している効率的なマ 
クロ定義によるシナリオ簡略化がご参考になれば嬉しいです。 

分担ですが、 「 IssisFactory 」 の吉田が原画、彩色、背景 CG などのグラフィ 
ック全般を、そして「横浜かまいたちファンクラブ」さんのスタッフの方々が 
シナリオとサウンド、全体のコーディネイトを手掛けてくださっています。 



( 文： 『 IssisFactory 』 代表絵師 • 吉田神一） 


http://www.piass.com/issis/ 


演出®見所や KAG シナ LI 才のワンポイント 

アドベンチャーノベル風の画面レイアウトの 
ため、それぞれの用途に応じた前景レイヤー 
を6枚定義しており、必要に応じて [ laycount ] 
でレイヤー数を調整して使っています。 

また、本作はできるだけ BGM の使用を 
抑え、効果音による臨場感と聴覚刺激に 
よる恐怖を演出する方向で制作しているの 
で、 BGM 、 SE ともに OggVorbis 形式を採 
用しました。特に効果音については W . Dee さんが制作した 「 LoopTuner 」 と 
呼ばれるソフトで生成できる SLI ファイルを利用しています。 

さらに、背景絵、顔絵、立ち絵などは、すべて rissisFactoryJ の吉田神一 
氏にお願いし、ほとんどの立ち絵キャラクターに目パチアニメーションを採 
用、さらに重要なイベント絵については市販のゲーム同様1枚絵を書き下ろし 
てもらっています。 



「 IssisFactory 」 のポップなキャラと、 YKFC のシリアスなシナリオがマッチ 
するように気をつけながら、鋭意制作中です。 


( 文：『横浜かまいたちフアンクラブ』代表 P I A 少尉 ) 


http://www.piass.com/ykfc/ 
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物語というのは一人の人生の一部 pijppp ||— upg — pi — jjj — ^ 
分を垣間見るという行為だと思いま議ゝ’ ' ， A ：、 

すが、脇役にも同様に人生があり物| W ^ : 

語があります。その物語においては 

その脇役が主人公であり賺に脇役 WMW ^ _ 

が存在し、その脇役にもまた人牛.が^ »| HU | P | 

そう考えると一人の人間の人間関： P #| '圓 P : ; 

係というのはきわめて複雑です。そ ^ ^ 

の相関関係や感情の行き来を完全に認識することは不可能でしょう。 

「 Collage 」 の制作は、そのような謎を少しでも解き明かしたいというのが 
動機のひとつとしてあります。もちろんそんなことは不可能ですが..…•まあ、 
あまり難しいことは考えずに、「こいつとこいつがこうなるのかよ！」みたい 
な感じで楽しんで t 、ただければ幸 I 、です。 


この作品は move タグを多用 
することによって動きのある画 
面を構成し、プレイヤーを飽き 
させないように工夫したつもり 
です。また音楽や効果音と画像 
のシンクロも意識してたので、 
そちらも楽しんでいただけるの 
ではないかと思っています。 

吉里吉里2は非常に高機能で 
ァドベンチャーゲームを 製作す 
るということで想像されるイメージは、ほぼすベて再現することができます。 
はじめは少々面倒に感じるかもしれませんが、使えば使うほどできることの多 
さに開発が楽しくなると思います。とにかくやってみてください！ 




(文： 『Homegorosi PROJECT』 コミネト) 
















コマンド選択式アドベンチヤ- 『 Foster 』 



温泉宿での殺人事件の謎を追 m 
う、オーソドックスなコマンド選 
択式ァドベンチャーゲームです。 

殺人事件が発生した温泉宿で、 
事件の真相を追うために主人公が 
宿での聞き込みを開始します。 

ゲーム 中では時間が流れており、 
無駄な捜査をすると事件の真相に 
たどり着くことはできません。 

イラストはネット上でも活躍さ 


れている桜木晶さんにご協力いた 
だきました。どれもすばらしく、これだけでも一見の価値はあると思います。 


( 文 ： 『Red Letter 』 東真哉） 
http://hgashi.tripod.com/redletter/ 
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ン 『PicturalStory - twei-j 


http://hgashi.tripod.com/redletter/ 


( 文 ： 『Red Letter 』 東真哉 ) 


「 PicturalStory 」 の続編で、画 
家を目指す青年が女の子たちと繰 
り 広げる恋愛 (?) 物語が テーマの 恋 
愛シミュレーションゲームです。 

前作の設定は、修行のためにあ 
る街にやってきた絵描きを目指す 
青年が芸術の発展に力を入れてい 
るその街で、画家としての腕を磨 
きつつ、 絵のモデルを探し、恋を 

する-そんな物語でしたが、 

この編では絵のことなど何も知らな t ゝ青年が前作の舞台である街を訪れ、い 
いろいろな物語を繰り広げます。 ゲームの 目的は前作同様3年の間に女の子と 
親しくなって、絵のモデルになってもらうことです。 







収録作品紹介 


サイコホラーノベル『ガラスの中の少女』 


11の人格を持つ解離性同一性障害の 
患者の、妄想の中の殺人事件。しかし 
現実と妄想とが徐々に交錯してゆき、主 
人公の周辺で異常な事態が起こり始める 


「ガラスの中の少女」は、多重人格 
を テーマに 描くサイコ ホラー ノベルです。 

各章の最後でキーヮードを選択 • 取得 
し、クライマックス手前でキーワードを 
組み合わせて推理をするという、やや特殊なシステムを採用しています。問題 
編と解決編にわかれた犯人あて推理小説の、ホラー版といったところです。 

「最後の夏」と同様、「パソコンで読む小説」を意識して作ったものです。 
背景の多くは合成写真ですが、自己主張があまり激しくならないように、かつ 
絵になるように調整しました。音楽も、しっとりと落ち着いていて美しいもの 
をお借りしました。トータルバランスには気を配ったつもりです。 

演出の見所や KAG シナリオのワンポイント 

' デモシーンなどで音楽と画面のタイ 
ミングをあわせるためには、 [ reset - 
wait ] 、 [ waitmode = f , until M ] を使 V 、ます。 

ただし、画像を読み込むためのタイ 
厶ラグが生じるので 、「 touchlmagesj 
を使って画像をキャッシュに入れてお 
くか、「 assignlmages 」 を使って順次 
処理をする必要があります。 

また、作業フォルダで吉里吉里を走 
らせるのと、アーカイブ化した状態とでは、タイミングが変わってきます。 

わたしはこのあたりを（実はこれに限らず全編を）行き当たりばったりで適 
当に作業していました。何回調整したか数え切れません。製作には計画性が 
必要だと痛感しました。 

( 文：『林檎坂通信』管理人 SUZUNE) 
http://www2.odn.ne.jp/suzune/ 






















ホラー•アドベンチ ヤー ノベル 『 ZODIAC 』 


「ホラー•アドベンチャー」と「ノべ 
ル」。このまったく異なる2つの ジャンルを 
融合させた、新しい感覚のゲームです。 

雪に閉ざされた秘境古代都市、ゾウディ 
アックにやってきた主人公は、突然の雪崩 
に巻き込まれて仲間と離れ離れに。仲間を 
捜しながら助けを呼ぶべく歩き回る主人公 
ですが、彼の前に見たこともない怪物や謎 
めいた現象が立ちはだかります。ゾウディアックで何が起こったのか。そして 
主人公は無事に仲間を見付けて帰還できるのか。先の読めないストーリーがあ 
なたを待っています。 

また、 ホラー•ア ド ベンチャー ゲームには欠かせない謎解きにも力を入れて 
います。プレイヤーはステージ中に散りばめられたヒントを集めながら、謎を 
解いて先に進んでいきます。謎解きの難易度は高めなので、謎解きが得意な 
方、市販のソフトの謎解きが簡単すぎるという方にお薦めします。その他にも 
敵との 戦闘、 選択肢によって変化するストーリー、 マルチ エンディングなど、 
プレイヤーを飽きさせないように工夫をしています。ぜひ一度プレイして、こ 
の楽しさを味わってください。 



演出の見所や KAG シナ U 才のワンポイント 



本作品では複数の人間がスクリプトを 
担当したので、演出の統一に注意を払い 
ました。 

また、 BGM や背景画像のフヱードア 
ウト/インも、あまりやりすぎると ユーザ 
一にストレスを与えてしまうし、まった 
く意識しないと呆気のないゲー厶になっ 
てしまいます。そのバランスは製作者に 


よって違ってくるのでしょうが、演出上非常に重要な部分だと思います。 

本作品では行末クリック待ち（[1])の代わりにウヱイトタグを使用していま 
すが、ユーザーの評判はイマイチでした。製作者にとって重要なのは、自分が 


何を作りたいのかと、ユーザーが何を望んでいるのかを常に考えながら製作す 


ることかもしれません。 


(文：『ゾゥディアック』制作指揮陽炎） 
http://www.zodiac-series.com/ 

_ J 
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付録 




学園ホラー•アドベンチヤー『学校七不思議』 


学生なら、誰もが必ず一度は耳 
にする怪談話。七つあると言われ 
るけれど、七つ目はなぜか誰も知 
らない。「なぜ誰も知らないのに七 
不思議？」「七つ目を知ってしまう 
とどうなるのか？」。単に学校の怪 
談話を並べるだけでなく、その謎 
について考えた物語をゲームにし 


j 專字权七不思議 


( 文：『銀の盾』藍澤風樹） 

F http://hp.vector.co.jp/authors/VA022686/ | 

_ — _ J 


てみました。 

忽然と消えた二人の女生徒。彼 


女たちが f 肖えたのも、こんな暑い夏の日だった…。現在学生の人はもちろん、 
かつて学生だった人も、母校を思い浮かべながらプレイしてみてください。二 
部構成になっているので、ボリュームはあるかと。マルチエンデイングのため、 
すべての結末を見るのは大変ですが、クリアすると“おまけ”がありますの 
で、お楽しみに。 


途中の選択肢により、物 
語はさまざまに分岐します 
が、共通イベントはサブル 
ーチンを使っています。そ 
のぶん、シナリオは分かり 
やすくまとめることができ 
ました。 


演出®見所や KAG シナリオ©ワンポイント 
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フアンタジツク•シヨートシヨートノベル『最後の夏 


「最後の夏」は、失踪した猫をめ 
ぐって繰り広げられるファンタジック 
なショートショートで、ゲーム要素は 


いっさいありません。 

「パソコンで読む小説」を意識して 
作りました。縦書きの明朝体を採用し 
ていたり、右半分のみに文字表示ウイ 
ンドウをかぶせているのも、ウインド 
ウを本に見立てたからです。左側はさ 
し絵の部分というわけです。 

サウンドノべルと呼ばれるゲームでは、インタラクティブ感を高めるために、 
「主人公が見ている映像」または「主人公をとらえたカメラの映像」を表示す 
る場合がほとんどだと思います。挿絵方式は、独特といえばいえるかもしれま 
せん。続く「ガラスの中の少女」では、さらにイメージ映像に近いものが多用 
されることになります。 


_出®馬所や KAG シナ U 才©ワンポイント 

「吉里吉里1 /KAG 2」のスクリブ 
卜だということで、今回シナリオ•フ 
ァイルは CD への収録を見送らせてい 
ただきました。 

ほとんどが基本機能のみで、テクニ 
ック的にもあまり凝ったことはしてい 
ません。強いていえば冒頭の、文字が 
浮かび上がってくるところくらいでし 
よっか 0 [current layer = M messagel ,f 
withback = true ] という状態で [delay speed = n nowait , f ] に設定して文章を記述、こ 
のレイヤのトランジション処理を行います。 

次に、 [ ct ] でメッセージ.レイヤー0にフォーカスを戻し、先ほどと同じ文 
章を記述した後 、 [layopt layer = f , messagel M page = M fore ,f visible =" false n ] にして 
います。これを繰り返して、1行ずつ増やした文章を順次表示していっている 
わけです。 


収録作品紹介 
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家^£雒か^ふけても敉間〇*.ずとい0た体での 
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( 文：『林檎坂通信』管理人 SUZUNE) 
http://www2.odn.ne.jp/suzune/ 
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収録作品紹介 

リ 

广 — -- ——- ヽ 


コマンド選択式アドベンチャー『夢の終わり』 


アドベンチャーゲームと 言えば、 

昔は「見る」「調べる」などのコマ 
ンドを選んで進めていく形式がほと 
んどでしたが、最近はあまり見掛 
けません。それなら、自分で作っ 
てしまおうということで、昔懐かし 
い形式で制作しました。 

永遠の刻を生きる、ラルクとい 
う名の美しい吸血鬼がいる。彼は 
退屈と停滞を嫌い、旅を続けてい 
た。不老不死の彼を今宵待ち受けるは、死の臭いに満ちた村と、朽ちた教会 
で祈り続けるシスター。夢を見ていた者は誰？ その望みは…？ 

演出の見所や KAG シナ U 才のワンポイント 

コマン ドの表示は マクロで メッ 
セージ•レイヤーの雛形を作って 
おき、通常メッセージ表示時と 
切り替えて使っています。 

これに限らず、同じ形式を多 
用するときはマクロを活用すると 
とても便利ですよ。 フレーム 内 
画像の表示位置も、マクロで設 
定しました。 


(文：『銀の盾』藍澤風樹） 
http://hp.vector_co.jp/authors/VA022686/ 
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/ KAG 推進委員会 J について 


「吉里吉里/ KAG 推進委員会」（以下、「委員会」）は、吉里吉里/ KAG ユー 
ザーが集うインターネット上の コミュニティで、 吉里吉里/ KAG の開発者であ 
る W . Dee さんが正式に認可し、ほぼ常駐してくださっています。ですが、開 
発者の W . Dee さんにはできるだけ吉里吉里/ KAG の開発に専念してもら t 、たい 
という理由から、サイトの管理は私 （PI A 少尉）が不肖ながら務めさせて 
いただいています。 

現在の委員会サイトはユーザーの皆さんが質問や意見を書き込める掲示板や、 
作った作品を告知するための自由登録リストなど、「参加型」のコンテンツが 
中心になっています。 

このように当委員会は、開発者である W . Dee さんに認可いただ t ゝた唯一の 
支援系公式サイトとして、吉里吉里/ KAG 本体や、吉里吉里/ KAG によって制 
作された作品に関する情報の一元化を目指しています。 

現在のところ、当委員会は以下の4つの目的のために存在しています。 

① 吉里吉里/ KAG に関する各種情報の告知場所として 

② 同ツールを使う制作者のスキルアップの場として 

③ エンドユーザーと開発者の相互連絡の場として 

④ エンドユーザー同士の情報交換の場として_ 

吉里吉里/ KAG を使って何かを作ろうと考えている方は、ぜひ委員会へご参 
加ください。ネット上の最低限のマナーが守れる方ならどなたでもご参加いた 
だけますので、吉里吉里/ KAG に興味があるけど何が何だか分からな t ゝ方から、 
吉里吉里/ KAG で制作した作品を告知したい方まで、自由にご利用ください。 


なお、当委員会には参加のための面倒な手続きや審査などは一切ありませ 
んし、それよりも何よりも、入会や退会などの概念すら存在しません。ご自分 
が「ぼくは推進委員だ！」と自己表明した瞬間から、あなたは推進委員です。 
詳細に ついては 下記のサイトをご覧ください。 

吉里吉里/ KAG 推進委員会 
http :// www . piass . com / kpc / 
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###•## 


演算子一覧 



分類 

演算子 

使い方 

意味 

■ ..... - 


0 

⑻ 

演算の優先順位の変更 


0 

a () 

関数 a を呼び出す 


[] 

a[b] 

オブジェクト a のメンバ匕に 

アクセス(間接メンバ選択） 



a.b 

オブジェクト a のメンバ匕に 



アクセス(直接メンバ指定） 

関数 呼び 

後置++ 

a++ 

a に 1 を足す（式全体としては 

演算前の値を示す） 

出しなど 

後置-- 

a- 

a から 1 を引く（式全体として 

は演算前の値を示す） 


後置！ 

a! 

a の表わす文字列を式として評価 


mcontextof 

a incontextof b 

a のコンテキストオブジェク 

卜を b に変えたもの 


int 

int a 

a を整数型に変換 


real 

real a 

a を実数型に変換 


string 

string a 

a を文字列型に変換 


前置！ 

!a 

a の真偽を否定 



~ a 

a のビットを反転 


ma 

刖置 ++ 

++a 

a に 1 を足す（式全体とし 

ては演算後の値を示す） 

単項演算子! 

刖置-- 

—a 

a から 1 を引く（式全体と 

しては演算後の値を示す) 

など 

new 

new a() 

クラス a のオブジェクトを 

作成する 


invalidate 

invalidate a 

オブジ I ク ha を無効化する 


isvalid 

isvalid a または 

オブジェクト a が有効ならば 


a isvalid 

“真，， 
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delete 


delete a 


. 

画!::::、”::'：. 

typeof 

typeof a 


# 

#a 


$ 

$a 

単填演算子 

単項+ 

+a 

など 

単項- 

-a 


単項+ 

*a 

: . :: :: 

instanceof 

a instanceof b 


% 

a% b 

• 

乗除余算 

/ 

a/b 

演算子 

¥ 

a¥b 





* 

a*b 

加減算 
演算字 

+ 

a + b 

- 

a - b 

ビットシフト 

演算子 

» 

a » b 

« 

a « b 

»> 

a »> b 



変数またはメンバ a を削除 
a の型を調べる 
a の文字コード 
a のコードが表す文字 

a を数値型にする_ 

a の正負を逆にする 
プロパティオブジェクト a 
にアクセス 

a がクラス b のオブジェク 
卜ならば“真” 
a を b で割ったあまり 
a を b で割る（値は実数として 
扱われる） 

a を b で割る（値は整数と 
して扱われる） 

a と b をかける 
a と b を加算（文字列に対して 
は結合） 

a から b を減算 
a を b 回右に算術シフト 

(符号ビットを保つ） 

a が b 回左にシフト_ 

a を b 回右に論理シフト 
(上位ビットを0で埋める） 
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演算子一覧 


比較演算子 

、 . 

< 

a < b 

a が b より小ざければ“真” 

> 

a > b 

a が b より大きければ“真” 

<= 

a <= b 

a が b と同じか、あるいは 

a が b より小さければ“真” 

>= 

a >= b 

a が b と同じか、あるいは 

a が b より大きければ“真” 

_____ 

ノ 

, 'へ、ャ♦く, パ、 

词定子 

觀 ' ' 

== 

a == b 

a と b の値が同じならば“真” 

!= 

a != b 

a と b の値が異なれば“真” 

=== 

a === b 

a と b の型と値が同じならば“真” 

i 

!== 

a !== b 

a と b の型が異なるか、あるい 
は値が異なれば“真” 

ビット AND 

::議 

& 

a & b 

a と b のビットごとの AND 

(論理積） 

ビット XOR 

演算子 

A 

a A b 

a と b のビットごとの XOR 

(排他的論理和） 

ビット OR 

灌簠ネ 

網•丁 

1 

a | b 

a と b のビットごとの OR 

(論理和} 

論理_ 

雄: 笛 深： 

濶屏:す 

&& 

a && b 

a が“真”かつ b が“真”なら 

ば“真，， 

論理 OR 

麟弊^!^ 

II 

allb 

a が“真”または b が“真” 

ならば“真” 
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^アスキーテキスト . 76 

アセンブラ . 10 

アンチエイリアス . 160 

い イベント•ハンドラ……277,278 

イベント駆動型 . 277 

イベントドリブン . 277 

インデント . 78,221 

インライン画像 . 76 

无演算子 . 197 

エンティティ . 321 

お オーバーライド . 272 

オブジヱクト . 211,252 

親クラス . 270 

か拡張トランジシヨン . 44,55 

画像フォーマット.コンバータ…161 

関数 . 196,214 

間接メンバ選択演算子………259 

き 禁則処理 . 

く クラス . 239,254,264 

クリッカブル•マップ…132,312 
グローバル ■オブジェクト…253,291 

グローバル変数 . 238 

クロスフェード • トランジシヨン…44 

け継承 . 270 

ゲーム変数 . 99 



さ サブクラス . 270 

サブルーチン . 112 

参照 . 260 

三角形を表示 .. 59 

し 辞書配列 . 258,287 

システム変数 . 99 

実数 . 111,195,210 

条件式 . 230 

条件分岐 . 107 

情報ダイアログ . 184 

消滅子 . 269 

す数値変数… . 14,98,105 

スーパークラス . 270 

スキップ状態 . 152 

スクリプト•エディタ . 192 

スクリプト言語 . 190 

スクロール •トランジシヨン…14,44,53 

スコープ .. ……227,236 

ステートメント . 198 

せ 整数 . 111,209 

t -7. 89 

セ パレー タ . 85 

前景レイヤー . 60,281 

M.m . 204 

そ 即値 . 209 

属性 . 30 

た タイプ•ルーズ . 191,212 

$ ク '•••••. 30 

タグ•ハンドラ . 282 

ち 直接メンバ選択演算子 ……252,259 

てデータ 型 . 209 

デストラクタ . 269 

手続き型 . 277 

ァハッグ . 14 

と 等幅フォント . 79 

トランジシヨン . 14,293 
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s ラベル . 

乱数 . 

る ルビ . 

れ例外 . 

レイヤ • 
連想配列… • 

ろローカル変数 

口一! . .. 

論理 . 


A ActionScript 
assign . 

B break 文…. 

C C ++ . 

Config.~new 
Config.tjs •• 
continue 文 • 
C 言語•…… 

D do 〜 while 文 

E ECMA …… 
else . 

F Flash . 

or 文 . 

function •… 

I initialize.tjs • 
intrandam •••• 

J Java . 

JavaScript •• 
JScript . 


IS 背景レイヤ . 280 

配列 . *256 

パッチ . 324 

パラメータ . 181 

ハンドラ . 55 

ひ 引数 . 214 

否定演算子 . 231 

ぶ複合文 . 226 

プライマリ • レイヤ . 280 

フラグ . 98,105 

プラグイン . 55,154,162,286 

フリースタイル . 220 

プロジェクト . 202 
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あとがき 

ncAG 』 と itjsj 、 いかがでしたでしようか。 

この本では KAG と TJS の基本を学ぶことができたと思います。「基本的」というのはどう 
いうことかというと、 KAG も TJS も応用範囲が広く、考えつく限りにしても、応用的なこと 
をすベて紹介するとなると、膨大な量になってしまいます。しかしながら、今回執筆させて頂 
いた内容は、吉里吉里、そして KAG と TJS のエッセンスを伝えるには充分であると思います。 

知れば知るほどに応用は広がりますが、同時にさらに知りた t 、部分も増えてくるかと思い 
ます。この本を読まれた方々は、吉里吉里/ KAG の世界をもっと知りたいと思うようになる 
と思います。この本に書かれていない多くの情報は、吉里吉里/ KAG の SDK (ソフトウェア開 
発キット）付属のドキユメントに書かれています。インターネット上の索エンジンも役に立 
つでしよう0 

また、今回 CD - ROM に収録させていただいた作品の中には、そのソースを閲覧できるもの 
があります。他の人の作品をよく研究することも、より深い理解につながる良い方法だと思 
ぃます。 

「吉里吉里/ KAG 推進委員会」もぜひ ご 利用ください。インターネット上にある講座の自 
勳登録リストがあります。掲示板にお越しいただいて、質問すれば、きっと答えが返ってく 
ると思います 0 

これらの環境は、吉里吉里/ KAG をサボートする多くの方々によってつくられたものです。 
「謝辞」にも書 I ゝた通りですが、再度感謝申し上げた I ゝと思います。 

吉里吉里/ KAG はソフトウヱアのソースが公開されています。ソースを公開することによ 
り、ほかの開発者の方々のご意見を広く募ることができたり、あるいは実際に開発に参加し 
ていただくということが可能になります。また、ソース公開を前提とするプログラミングで 
はいい加減なことはかけません。必然的にプログラムをきれいに書こうという意識を、自分 
を含めた開発者自身にもたせることができ、結果的により良いソフトウヱア作りにつながっ 
ていくのだと思います。 

吉里吉里は発展途上のソフトウェアです。日々改良、機能追加が行なわれています。これ 
は作者の力の続く限り続けていきたいものです。どうぞ、皆様の暖かいご支援を引き続き賜 
りたく、お願い申し上げます0 

2003年§ 月吉日 W.Dee 











思い起こせば 1 999年の12月0 


軽い気持ちでダウンロー ドした吉里吉里のサンプルに衝撃を受け、こんなすごいツールを 
制作しているのはどんな人なのだろうとサイトを訪問させていただいたところ、おや、と思 
える一文を発見しました。 

1999/8/24進捗 

なんか、吉里吉里本体は開発が止まっているというか、なんというか。使って 

くださっている人からのレスポンスが今のところ皆無に等しいので(泣） 

モニタに向かって「こんなすごいソフトなのになぜだ!?」と声に出して叫んだ自分は、「こ 
のままではいかん丄と焦りました。4ヶ月も前の発言でこの状態では、すでに開発者のモチ 
ベーションがどん底まで落ちており、ひっそりと闇に葬られてしまっているかもしれぬ。メ 
ールを出そう。出して、ここに一人でも応援している人間がいることを伝えねば！ 

——と、こんな経緯で衝動的に W.Dee さんに初メールを差し上げたそのときから、私の 
「KAG と心中」人生は始まったのであります。 

本書にも書かせてもらいましたが、このソフトは「これをしたい J という要求のほとんどに応 
じてくれます。最初に敷居をまたぐだけの努力さえすれば、あとはどんどん手に馴染んできま 
す。アドベンチャーやノベルだけではなく、シミュレーションゲームやパズルなどはもちろん、 
プレゼンテーション•スライドや学習教材などにも幅広く利用できます。私自身、それほど 
使いこなしているわけではないのがお恥ずかしいのですが、このソフトを学習される方のため 
に必死になって書いた本なので、本書の内容が少しでも皆様のお役に立てたら嬉しいです。 

最後に、この場をお借りしてこの本を世に出すためにご協力いただいた皆様への謝辞を述 
ベさせていただきます。共著に私のような1ユーザーを抜擢して下さった吉里吉里/ KAG 開 
難者の W.Dee 様、本稿内の立ち絵や背景 CG のみならずソースレベルの作品を快くご提供く 
表さった IssisFactoiy の吉田神一様と『地球のあくび』のうにゅ〜様、ソースレベルでの収 
録をご快諾下さった京秋人様、朝から炒飯様、グロァ様、作品収録のご協力をいただいた藍 
澤風樹様、 SUZUNE 様、東様、陽炎様、コミネト様、素材を提供してくださった Dauge 様、 
お世話になった吉里吉里/ KAG 推進委員会の皆様、每晚遅くまで原稿を書く自分の心身を支 
えてくれた我が妻、そしてこの本を手に取って下さったあなた。 

本当にありがとうございました。 


2003 年 5 月吉日 P_A 少尉 
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W.Dee 

本業はソフトウェァ開発。 C / C ++ や Perfx PHP を操る。 

趣味はフリーソフト作り。吉里吉里もそんなフリーソフトの一つで、最初のバージョンを公開してから4年。 
もともとは自分たちでなんか一本ゲームでも作ろうとしていて、じゃあなにかここで永く使える巩用的なも 
のを作っておこうと思ったら、システム • ブ a グラムだけが一人歩きして現在にいたる。 

• kikyou.info 
http :// kikyou . info / 


PIA 少尉 ♦ 

大学時代、 ASCH - NET 、 PC - VAN 、 N 〖 FTY - Serve のパソコン通信にはまり、デビューして以来このハンドル 
でネット活動を続け、今年でネット歴15年。 

大学卒業後、勢いだけで大手ソフトハウスに入社するも6年間の勤務に疲れ、休職して海外に逃亡。 

20世紀末、ノストラダムスの予言を母国で迎えるために帰国。その後平凡なサラリーマンに戻り、結婚し 
て索庭をもつという日本の典型的なオヤジ道を歩くことに。 

今では KAG と花を愛しづつ悠々自適な日々を送る好々爺。趣味はガーデニングと KAGU こよるゲーム制作。 
好きな樹木はメガネヤナギとムクゲ。 
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《質問に関して》 


本書の内容に関するご質問は、 

t 用の切手を同封した手紙 


① 返信用の切ヱ 

② a 復はがき 


③ FAX (03)5269-6031 

《ご自宅の FAX 番号を明記してください） 

④ E-mail iomook @ kohgakus 1 ia . co.jp 

のいずれかで、工学社第二 I / O 編集部宛にお願いします。 
電話によるお問い合わせはご遠慮ください。 
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